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Introduction to AdminStudio 5.5 


The Help Library provides unified access to AdminStudio help. This library's help topics contain information about 
AdminStudio's functionality and features. For new information about AdminStudio that may not appear in this help 
system, visit the InstallShield Knowledge Base. 


The following sections will assist you in learning about AdminStudio: 


Section 


Using the AdminStudio Interface and AdminStudio Security 
Get an overview of AdminStudio functionality, including AdminStudio security (InstallShield AMS 2.0-only). 


Repackaging Legacy Setups 


Learn how to repackage and convert legacy setups into Windows Installer packages. 


Configuring Exclusions 


Rag 


Learn how to use the Global Exclusions Editor to configure Repackaging, Global Project, and OS Snapshot 
exclusions. 


Authoring and Enhancing Packages 


Learn about InstallShield DevStudio and integrated AdminStudio functionality. 


Customizing Packages 


he 


Learn how to use Tuner to add to, modify, or remove information from a Windows Installer package. 


Isolating Applications 


Ê. 


Learn how to use the Application Isolation Wizard to reduce versioning conflicts by modifying an application so it 
always loads the versions of components— such as DLLs—with which it was originally developed and tested. 


Ensuring Package Quality 


Get an overview of the new QualityMonitor™ tool for AdminStudio Professional Edition. 


Identifying and Resolving Application Conflicts 


Learn how to identify and resolve conflicts between Windows Installer Packages (AdminStudio Professional and 
InstallShield AMS 2.0-only). 


Preparing Packages for Distribution 


2 @& 


Get your packages ready for network, FTP, Marimba, Tivoli, or SMS distribution. 
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Welcome to InstallShield AdminStudio 


Dear InstallShield AdminStudio Customer: 


Thank you for choosing InstallShield AdminStudio 5.5. We are dedicated to providing you with the most innovative 
software distribution technology available. Our commitment begins with listening to you. We welcome your 
comments and suggestions about InstallShield AdminStudio and its documentation, or any other input you might 
have. Please contact us at http://support.installshield.com, or by clicking the feedback link available at the bottom of 
each help topic. 


Please visit our Web site at http://www.installshield.com for additional AdminStudio information, the latest 
InstallShield news, hot installation and application migration topics, technical white papers, and downloadable files. 


We look forward to hearing from you. 
Sincerely, 


Viresh Bhatia 
CEO, InstallShield Software Corporation 


The AdminStudio Development & Support Team 
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What's New in AdminStudio 


AdminStudio 5.5 includes the following new features: 


Feature 


Description 


Flawlessly Package 
InstallShield Setups 


Only InstallShield SmartScan™ automatically scans scripted setups authored with 
InstallShield technology, preserving their entire feature organization, and accurately 
packages them as MSls. 


Diagnose and Repair 
Installed Applications 


MSI Doctor™ automatically determines if an installed application needs repair, what repair 
is needed, and why. It shows you the "insides" of the installed application and lets you 
easily identity and fix difficult-to-diagnose problems. 


Easily Build Your Own 
Installations 


AdminStudio now comes with InstallShield DevStudio™, which makes it easy to author and 
modify your own customized installations, patches, and updates for any workstation or 
mobile device. 


Pre-Deployment 
Isolation Testing 


Ensure your packages won't interfere with each other by automatically scanning them 
before deployment to determine if they are fully isolated and using only local resources 
and DLLs. 


Problem-Free Software 
Patch Deployments 


Deploying untested software patches can cause IT catastrophic problems. AdminStudio 
automatically detects and eliminates any conflicts your patches may cause before you 
deploy them. 


Efficient Interoffice 
Software Management 


For organizations managing software in multiple offices, AdminStudio ensures you never 
waste time duplicating work. One location can now publish software packages fo IT teams 
at other sites, keeping all teams current while enabling each to manage their software 
independently. 


Transform 
Management 


Automatically identify and eliminate conflicts in multiple configurations of the same 
package, including transforms - making conflict resolution faster and more complete. 


Resolve Marimba 
Package Conflicts 


Automatically eliminate any conflicts between Marimba NCP packages and your installed 
applications before deployment, guaranteeing seamless rollouts of your Marimba 
packages. 


Interactive Catalog 
Searching 


Easily search the Application Catalog to instantly find information on all software 
(applications, patches, transforms, DLLs, etc.) in your entire organization. Now you can 
quickly determine what impact any deployments or file changes will have on all the 
software in your enterprise. 


SMS 2003, Altiris®, 
and LANDesk® 
Support 


AdminStudio automatically creates deploy-ready packages for SMS 2003, Altiris, and 
LANDesk distribution systems, enabling you to deploy your software correctly in less time 
without being a distribution system expert. 
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Feature 


Description 


Automatically Enforce 
Corporate Standards 


The new Conflict Resolution Wizard lets you set up a standard, automated process for 
fixing applications that violate your corporate standards. Once you've defined the process, 
AdminStudio automatically fixes future violations for you, saving you time and ensuring 
your software always meets your standards. 


Multiple Package 
Conflict Testing 


Save time by having AdminStudio automatically check multiple packages simultaneously 
for any number of conflicts against any application and operating system in your 
enterprise. 


Conflict Error Grouping 


AdminStudio makes it even easier for you to disseminate, organize, and understand large 
amounts of conflict error and warnings by grouping them graphically in collapsible trees. 


Build Complex Custom 
Conflict Checks 


AdminStudio now includes programming interfaces and a development library, enhancing 
your ability to build complex checks to automatically enforce your company standards. You 
can also integrate your own logic with AdminStudio's ConflictSolver to better find, track, 
and fix conflicts and standards violations. 


Locked-Down User 
Testing 


Locked-down tests can now be executed under a different login account, ensuring your 
application will run reliably for users with lower permissions. 


Remote Package Alert 


Receive automatic notification whenever applications in other Application Catalogs in your 
organization are altered or updated, ensuring you never duplicate another IT team's work 
and your Catalog is always up to date. 


Automated Scripted 
Setup Conversion 


You never have to waste time packaging a scriptbased setup created with InstallShield 
DevStudio. Just run the installation, and AdminStudio automatically generates the MSI 
package for you. 


Microsoft MSDE 
Support 


AdminStudio now includes built-in support for the scaled-down Microsoft MSDE database 
engine, which gives you the benefits of SQL Server without the expense. 


Automatic OBDC 
Testing 


QualityMonitor™ now automatically tests any ODBC database connectivity used by a 
software package to ensure the drivers are correctly installed and configured, saving you 
time and increasing package quality. 


Manage Legacy Setups 


AdminStudio lets you import your non-MSI installations - including EXEs - into the 
Application Catalog for more effective management. 


Feedback 


InstallShield has made its reputation as an industry-leading provider of software solutions by following one simple 
tule: listen to the customer. To make our Administrator solutions as valuable and effective as possible, we need your 


input. Please help us make your software choice even mote flexible, robust, and easy to use. We appreciate comments 


on product, documentation, as well as service and suggestions. All your thoughts are welcome. Please share them 
today. And thank you for choosing InstallShield. 
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You can make feature requests, report bugs, or provide technical and/or documentation feedback from the Feedback 
page on our Web site at http://www.installshield.com/feedback. Select AdminStudio from the InstallShield Products 
list and enter your feedback in the resulting form. 


Additionally, if you want to provide feedback about a particular topic in this help system, click on the Feedback image 
at the bottom-right of the topic. This links to the feedback page on the InstallShield Web site, and automatically 
provides the product version and name of the help file. This helps us quickly address customer issues with specific 
Help Library topics. 
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InstallShield Information 


About InstallShield Software Corporation 


Founded in 1987 by Viresh Bhatia, CEO, and Rick Harold, CTO, InstallShield is most widely recognized for 
standardizing the way traditional software is installed on over 250 million PCs around the globe. Today, the company 
continues evolving that standard, providing ISVs (Independent Software Vendors), corporate developers, systems 
administrators, and digital content producers with cutting-edge technologies, products, training and consulting 
services. Our products enable the distribution, management, and consumption of software and digital content via the 
Internet and throughout the corporate enterprise. Our customers span every industry, from multi-national 
corporations to small businesses. Despite our industry-leading position and global presence, we maintain an 
entrepreneurial culture to address the full spectrum of software installation and deployment needs. 


Fast Facts About InstallShield 


m Four-time member of the prestigious "Inc. 500," Inc. Magazine's listing of America's fastest growing private 
companies 


m Recognized as one of greater Chicagoland's fastest growing technology companies by Deloitte & Touche "Fast 50" 
Program 


E Ranked by Media Metrix, Inc., as the sixth-most-frequently owned and eighth-most-frequently used software 
m Ranked #257 in Software Magazine's Software 500 List 
m Ranked #40 in the 2000 Softletter 100, a ranking of the top 100 PC software makers 


Technical Support Resources 


InstallShield's Product Support Services team hosts a wealth of options for you to find your solution. Web-based 
resources such as our Knowledge Base provide quick access to years of service at no cost, while service plans give you 
more robust support with our expert engineers. Take a look at your options below and see which solution is right for 
you. 


Online Help 


When you have questions about AdminStudio, first consult the online AdminStudio Help Library. Help is available 
both from the Interface Help menu, from all AdminStudio tools, and directly from certain individual Interface 
elements. 


The help resources listed below are available from within InstallShield AdminStudio. 


Help Library 


The Help Library is your complete user's guide for AdminStudio. This library contains reference materials that cover 
every aspect of your setup development. 
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Context-Sensitive Help 


Online help is available for every dialog box, Wizard panel, and view in the AdminStudio Interface and individual 
AdminStudio tools. Press the F1 key or click the Help button to view the Interface Reference help for the current 
dialog box. 


Web-Based Help 


Consult the Support section of the InstallShield Web site ( http://support.installshield.com) for immediate access to 
an extensive selection of useful information. The site is a comprehensive resource of free support materials including 
the following: 


Technical information and product news 

Sample projects 

Frequently asked questions 

White papers 

Documentation updates 

Maintenance releases and updates for registered software 
Information about consulting, support, and professional services 


This information is available to you 24 hours a day, 7 days a week. 


The Official InstallShield for Windows Installer 
Developer’s Guide 


This authoritative guide shows how to create and deploy software applications using the new Microsoft Windows 
Installer Service and the powerful installation tool, InstallShield Windows Installer Edition. 


This is the only official guide to the InstallShield family of Windows installation tools. 


Thorough coverage of the Windows Installer Service which includes a new and complex set of policies and software 
APIs that application developers must master to meet Microsoft Windows logo requirements. 


This essential reference guide for any MSI DevStudio is now available from retail booksellers. 


InstallShield Knowledge Base 


The InstallShield Knowledge Base is located in the Support section of our Web site (http://support.installshield.com). 
It contains answers to many commonly asked questions and includes new information about InstallShield that may 
not appear in the documentation. You can use the Knowledge Base search engine to search articles by phrases, 
numbers, platforms, and version. 


InstallShield Community Forums 


The InstallShield Community forums are another excellent resource when you have questions about InstallShield 
AdminStudio. In these forums, system administrators like you share tips and ideas and help each other get the most 
out of AdminStudio. Visit the InstallShield and InstallShield AdminStudio forums in the Support section of our Web 
site (http://support.installshield.com). 
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InstallShield Customer Care—Technical Support 


Take advantage of InstallShield's comprehensive resources that help you find the answers you need. Connect to 
http://support.installshield.com for information about our support options if you have not already contracted for 
support. 


Contacting InstallShield Customer Care 
Whenever you contact technical support, our Support Engineers will need the following information: 


E Your full name and the full name of the registered user, if different. 
E Your street address, telephone number, and email address. 


E Your InstallShield AdminStudio serial number. Support is available to registered users of InstallShield 
AdminStudio, so it is imperative for you to register your software. 


m The full InstallShield AdminStudio version number. To find this number, select About InstallShield AdminStudio 
from the Help menu. 


m The system information for the computer on which the problem occurred, including the make and model of the 
machine and video driver, the operating system, the amount of memory and system resources, any relevant devices 
or peripherals, and any system DLLs you are using. 


m A detailed description of the problem. Describe any error messages exactly as they appear. Please list all of the 
steps and conditions that led to the problem. 


Our Support Engineers are available on the World Wide Web (http://support.installshield.com) or by phone if you 
have purchased a qualifying InstallShield Support Plan. For more information about these plans, please consult our 
Web site. Registered users of InstallShield AdminStudio are also eligible for limited Web-based support at no 
additional charge. Details can be found in the Support section of the InstallShield Web site. 


Support Programs 


In addition to the award-winning resources of our support Web site, InstallShield offers a number of support plans 
that are fine-tuned to specifically meet your needs. 


Support Plan Description 


Public Resources Any time, day or night, access our knowledge base, newsgroups, and the sample gallery for 
outstanding support resources. 


Bronze Unlimited support for requests submitted through our Web site. 
Silver Unlimited support for requests submitted by phone and through our Web site. 
Gold Priority response and preferential queuing to dedicated engineers. Additionally, this plan allows you to 


participate in our Beta Programs. 
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Support Plan Description 


Platinum Get personalized service that is fine-tuned to meet the needs of your organization. In addition to the 
services provided under the Gold service plan, Platinum support provides you the option of having a 
Customer Care manager oversee all of your technical issues. The Customer Care manager is 
responsible for all issues submitted by your organization and holds optional conference calls every 
month regarding status and resolution open issues (if any). This plan also provides the option of having 
Web-based demonstrations and product assistance through the WebEx online meeting technology. 


For more information about InstallShield's support plans, visit our Support Web site at 
http://support.installshield.com. 


InstallShield Professional Services 


InstallShield Professional Services is made up of InstallShield Consulting Services and InstallShield Training. 


InstallShield Consulting Services 
No One Knows More About Installations than We Do 
Bottom line: we've solved more than half-a-million man-hours (250 years) worth of difficult installation challenges. 


As the industry's recognized experts, we have the unique capabilities necessary to ensure a successful first experience 
for your customers, keep difficult projects from impacting your ship dates, and lower your technical support costs. 


We know the technology challenges and we own the solutions. Our teams, with the support of InstallShield's larger 
technical base of product developers, will help you determine and implement the best solution to any and every 
installation and deployment challenge. Here are just a few available solutions: 


Solution Description 

Windows 2000 Application We can deliver a jump-start package to involve you right away or we can customize a 

Migration Practice migration and training package for your unique needs. 

Web and Network We can help you optimize your network for setup and installation, create personalized 

Deployment Internet deployment, or manage Web updates. 

Multimedia Go from bland, lifeless software deployment to a dynamic, engaging experience that 
improves your image, eases user navigation, and presents engaging cross-selling 
messages. 


Since 1990, we've been helping the industry with important projects, offering the expertise only an industry leader can 
provide. Many InstallShield consultants are former InstallShield developers, and all have thorough training and 
expertise. So with InstallShield Consulting Services, you can be sure your projects are being handled by the best 
possible resource backed by the leaders in installation and deployment. 


Contact us through the InstallShield Web site (http://www.installshield.com) today and see what we can do for you! 
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InstallShield Training 
Master Software Installation, Deployment, and Demonstration 


Get started quickly or learn robust functionality: it's all available from InstallShield Training. With introductory and 
advanced courses, you can grasp the basics and understand the advanced features of your product, learning how to 
create solutions for complex software distribution and deployment requirements in less time. 


The time you spend in an InstallShield Training course is focused on helping you learn every technique and feature 
available in your InstallShield software solution so that you deploy faster, author with more custom skill and control, 
and meet the specific, strategic requirements of your organization. Here's just a few skills available in several classes: 


m How to use AdminStudio's Repackager to convert traditional setups into Windows Installer setups. 


m How to take advantage of the Microsoft Windows Installer service for the highest level of integration with the 
operating system. 


m How to create a completely script-driven installation solution. 
m How to use InstallShield's One-Click Install™ technology to distribute applications over the Web. 


m How to build installation program that runs on multiple platforms, including Windows, Linux, Solaris, ATX, and 
OS/2. 


m How to launch applications or installation programs live from a demo. 


We want to help your company deliver a more robust installation with more efficient development and quicker time- 

to-market for your important applications. And we want to help you advance your skill set, learn valuable techniques 

from an industry leader, and share your experiences with fellow attendees and technical InstallShield staff. Our goal is 
to provide educational excellence and "tell-a-friend" value. Every time. 


Find out more from the InstallShield Web site (http://www.installshield.com) and sign up for a class today! 


InstallShield Training Centers 


InstallShield has thirteen North American training centers, plus four international training centers to serve you. 


North American Atlanta, GA Orlando, FL 

Training Locations Austin, TX Raleigh, NC 
Dallas, TX San Jose, CA 
Denver, CO Schaumburg, IL 
Farifax, VA Toronto, ON 
long Beach, CA Woburn, MA 
New York, NY 


International Training Bristol, United Kingdom 

Locations Glostrup, Denmark (manuals and tuition in English) 
Hamburg, Germany (manuals and tuition in German) 
London, United Kingdom 


Melbourne, Australia 

Munich, Germany (manuals and tuition in German) 
Naarden, Netherlands (manuals and tuition in English) 
Paris, France (manuals and tuition in French) 

Saronno, ltaly (manuals and tuition in Italian) 

Sydney, Australia 
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Legal Information 


InstallShield® AdminStudio® 5.5 Online Help Library 


COPYRIGHT. © 1997-2003 InstallShield Software Corporation. All rights reserved. No part of this document may be 
reproduced or retransmitted in any form or by photocopying, recording, information retrieval, or any other means. Pursuant to 
17 U.S.C. 512, we designate the following person as our agent to receive notifications of claimed infringement: 


Mr. Tyler W. Sheffield 

Chief Financial Officer 

InstallShield Software Corporation 
900 National Parkway, Suite 125 
Schaumburg, Illinois 60173 
tyler@installshield.com 


TRADEMARKS AND SERVICE MARKS. You may not use any trademark or service mark without the permission of the owner 
thereof. Marks owned by InstallShield Software Corporation include, but are not limited to, InstallShield®, AdminStudio®, It All 
Starts Here®, Un-InstallShield®, ReadySell®, Package for the Web®, Installfromthe Web®, DemoNow®, InstallShield 
Professional™, InstallShield DevStudio™, InstallScript™, InstallShield DigitalWizard™, DigitalWizard by InstallShield™, 
OneClickInstall™, NetInstall™, NetInstallShield™, DemoX™, ConflictSolver™, Application Isolation Wizard™, and 
QuickPatch™. Marks owned by Microsoft Corporation include, but are not limited to, the following: Microsoft Windows®, 
Windows NT®, FrontPage®, and logos relating to the foregoing. Marks owned by Adobe Systems Incorporated include, but are 
not limited to, Adobe Acrobat®. 


SOFTWARE LICENSES. Your use of any InstallShield software is subject to all terms and conditions set forth in the applicable 
license agreement. 


DISCLAIMER OF WARRANTY/LIMITATION OF DAMAGES. THIS HELP SYSTEM IS PROVIDED BY INSTALLSHIELD FOR 
INFORMATION PURPOSES ONLY, AND ONLY TO LICENSED USERS OF THE ADMINSTUDIO PRODUCT. INSTALLSHIELD 
ASSUMES NO OBLIGATION FOR THE ACCURACY OF INFORMATION PROVIDED AND NO OBLIGATION TO UPDATE SUCH 
INFORMATION. THIS HELP SYSTEM IS PROVIDED ON AN "AS IS, WITH ALL DEFECTS" BASIS AND WITHOUT WARRANTY 
OF ANY KIND. ALL WARRANTIES, CONDITIONS, REPRESENTATIONS AND INDEMNITIES, WHETHER EXPRESS OR IMPLIED, 
ARISING BY LAW, CUSTOM, PRIOR ORAL OR WRITTEN STATEMENTS OR OTHERWISE (INCLUDING, BUT NOT LIMITED TO 
ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, SATISFACTORY QUALITY, TITLE AND 
NON-INFRINGEMENT AND THE IMPLIED WARRANTIES AND CONDITIONS AGAINST HIDDEN DEFECTS ("VICES 
CACHES")), ARE HEREBY OVERRIDDEN, EXCLUDED AND DISCLAIMED. 


IN NO EVENT SHALL INSTALLSHIELD, ITS LICENSORS OR SUPPLIERS OR ITS OR THEIR RELATED COMPANIES BE LIABLE FOR 
ANY CONSEQUENTIAL, INDIRECT, SPECIAL, PUNITIVE OR INCIDENTAL DAMAGES OR LOST PROFITS, WHETHER 
FORESEEABLE OR UNFORESEEABLE, BASED ON CLAIMS OF YOU OR ANY OTHER PARTY ARISING OUT OF BREACH OR 
FAILURE OF EXPRESS OR IMPLIED WARRANTY, BREACH OF CONTRACT, MISREPRESENTATION, NEGLIGENCE, STRICT 
LIABILITY IN TORT, FAILURE OF ANY REMEDY TO ACHIEVE ITS ESSENTIAL PURPOSE OR OTHERWISE. NOTWITHSTANDING 
THE FORM (e.g., CONTRACT, TORT OR OTHERWISE) IN WHICH ANY LEGAL OR EQUITABLE ACTION MAY BE BROUGHT, 
IN NO EVENT WILL INSTALLSHIELD OR ITS SUPPLIERS BE LIABLE FOR DAMAGES OR LOSSES THAT EXCEED THE FOLLOWING 
FOR ANY BREACH OR SERIES OF RELATED BREACHES: (i) WITH RESPECT TO SOFTWARE, THE AMOUNT OF LICENSE FEES 
PAID BY CUSTOMER FOR THE SOFTWARE THAT GAVE RISE TO SUCH DAMAGES OR LOSSES; AND (ii) WITH RESPECT TO 
ANY SUPPORT OR OTHER SERVICES, THE AMOUNT OF FEES PAID FOR THE SUPPORT OR SERVICES THAT GAVE RISE TO 
SUCH DAMAGES OR LOSSES. 
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The Windows® Installer service introduces a faster, more reliable method of application installation. Standardized 
application installation, enhanced management, and easy customization of applications are some of the many benefits 
Windows Installer provides. Another important function of Windows Installer is its ability to diagnose and repair 
configuration problems when the application is opened. 


An integral part of the Windows 2000, Windows Me (Millennium Edition), and Windows XP operating systems, 
Windows Installer provides a standard format for component management as well as an interface for managing 
applications and system tools. Windows Installer is available as a redistributable for Windows 95, Windows 98, and 
Windows NT 4.0 operating systems. 


Windows Installer delivers this enhanced performance through a combination of application advertisement, on- 
demand installation, and related technologies. Advertising applications enables software to be potentially available to 
many users. On-demand installation allows the seamless activation of an advertised feature or product without 
requiring the user to exit from the current program in order to run a separate setup program, a process which often 
necessitates restarting the computer. There are two methods of advertising applications on a system: assigning and 


publishing. 


Windows Installer allows installations at the product level and at the feature level. When an end user calls an 
advertised product or feature, the operating system recognizes the installer “path”, which might be a shortcut, 
extension, or class ID (CLSID). The operating system requests the full path to the application or feature from the 
installer, which then queries the system to return its state, installs the application or feature, and returns the full path 
to the operating system to enable the application to be launched or the feature to be enabled. 


The Windows Installer service requires installation packages to be in the Windows Installer format, a specific, 
structured storage format. These files have the extension .msi and have four primary components: 


Component Description 

Summary information The header to the package file contains information such as version, date, and vendor. 
Database of installation This is the most critical component of the MSI package file. It is a relational database 
instructions consisting of many tables holding data and instructions. The information in the database 


determines what files, registry entries, shortcuts, etc. are implemented and under what 
conditions. There are three unique tables associated with instruction sequences and many 
supporting data tables. 


Application files or The application files can be included in a compressed form, or pointers to them can be 
references to them provided. 
Transforms The MSI file can optionally contain one or many Transforms, which are templates for table 


modification. Administrators or users have the option to apply these modifications after the 
base package has been created. Transforms can be used to meet the needs of specific 
machine types, departments, etc. Transforms can also be saved as independent MST files. 
The availability of Transforms enables the use of a single base package file across groups 
with highly diverse requirements. 
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In its simplest terms, a setup is the "package" used to install files and programs onto an end user's machine. It is a 
complete collection of the application files, as well as the component that interacts with the Windows Installer. The 
primary task of any setup is to transfer the application files from the setup disk to the end user's computer, whether it 
is a traditional Windows setup or a setup designed to interact with Window Installer. However, the complexities of 


the Windows operating system make it difficult to create an effective, coherent setup without the aid of a tool such as 
InstallShield DevStudio. 


If you have ever installed a product onto your computer, you have seen a setup in action—from the end user's 
perspective. The setup transfers files from the source medium to your local drive. It also makes the required registry 
entries, creates shortcuts, and registers COM servers. Setups commonly gather information about the target machine 
and the user. 


Typically, setups perform the following functions: 


Function Description 


Perform File Transfer File transfer involves copying files from the source medium, such as a CD or DVD, to a local 
drive on the end user's machine. Depending on the configuration the end user chooses, all or 
only some of the files may be transferred to the local disk. During file transfer, a setup can 
display billboards that provide product information such as new features or usability tips. A 
status bar may also be displayed to show the progress of the file transfer process. 


Display a User The user interface of a setup provides information and setup configuration choices to the end 

Interface user. Through the user interface an end user can choose to install only part of a product, choose 
to leave some files on the source medium, view a license agreement, or provide information to 
the installer that may be necessary to ensure the proper configuration of the installation. 


The user interface can be customized to meet the needs of your setup. For example, you can 
prompt a user for a serial number before starting the installation to protect your software against 
illegal use. 


Create Shortcuts Shortcuts are links to files and applications that the setup creates on the end user's machine. 
Shortcuts are usually placed on the desktop or in the Start menu of the target machine to provide 
quick and easy access to a program or its files. 


Register File If your product uses a distinct file type, you must register the file type for your application on the 

Associations end user's system to ensure your end user's system opens the file with the proper application. 
For example, if your application creates and uses files with the .txt extension, you need to 
register this file type during your application's setup. 
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Function Description 


Register COM, COM+, COM servers—such as ActiveX, COM, and COM+ files—require special registration so that 

and DCOM Files applications can access the files. Traditionally, these EXEs, DLLs, and OCXs contain self- 
registration functions that are invoked to register the files during installation. However, relying 
on self-registration can cause problems: the end user cannot always be certain of what 
information is being registered or that the registry entries are removed completely when the file 
is uninstalled. 


The Windows Installer service solves this problem by writing the necessary registry entries 
during setup and then removing them when the COM component is uninstalled. This method 
ensures that all the COM servers are registered appropriately whether the file is immediately 
installed or advertised. 


Register Product for To uninstall a product, the operating system must have some indication that the product is 

Uninstallation present. To accommodate this, a setup registers an application with the operating system so that 
it can be easily uninstalled. This registration is required for Designed for Windows logo 
compliance. 


Much of the information registered in this process is available to the end user through the 
Add/Remove Programs dialog box (on Windows 2000 and later systems). For example, 
technical support contact information, product update information, product version, and product 
publisher information are registered in this process. 


Installation Packages 


An installation package contains all the information Windows Installer needs to run an installation or uninstallation 
routine for an application, including setup user interface information. Each package contains an MSI file containing an 
installation database, a summary information stream, and data streams for various installation parts. In addition, the 
MSI file can also contain transforms, internal source files, and external source files or cabinet files required by the 
installation. 


Transform Files 


The Microsoft-designated term transform refers to a specific file type used to customize a Windows Installer-based 
installation. A transform contains all modification information, such as whether features are installed, how they are 
installed, which files, shortcuts, and registry entries are included, and Windows 2000 and XP Add/Remove Programs 
information. Transform files use an .mst extension. 


For example, you may need to customize an installation for different departments in your company. Typical business 
productivity suites come with a spreadsheet program, a word processor, and a presentation tool. Your accounting 
department may only need the spreadsheet and the presentation programs. On the other hand, the writing department 
may need only the word processor and the spreadsheet. A third department may need the entire suite of applications. 
Instead of manually setting up every person in the company, you can take the original setup of the entire suite, and 
create a customization project in the form of a transform to meet the needs of each department. A transform would 
need to be created for every configuration that you plan to use. 


Once you have created a transform, you can apply it at run time, depending on whose machine the application is 
being installed on. For example, in the accounting department, the transform limits the installation to include only the 
spreadsheet and presentation programs. 
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In some cases, it may be necessary to have multiple transform files for an installation. For example, a vendor may use 
a transform file for language-specific information. When you want to customize that MSI file, you need to include the 
preexisting transform so your modifications affect the entire existing package. 


MSI and MST Files 


An MSI file is a Windows Installer setup package in its completed state. It includes setup source files, and can have 
compressed within it all of the application's data files. The MSI file is the one that is distributed to the end users and 
interacts with the Windows Installer service in order to install the application on their machines. 


MST files are what Microsoft terms transforms. These are customization files that contain changes to the base MSI 
file. 
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The AdminStudio Interface is the central application for AdminStudio. From it, you can launch the AdminStudio 
tools, create workflow templates and projects, view the QuickStart Guide, connect to and create Application Catalogs, 
and configure AdminStudio Security (InstallShield AMS 2.0 only). You can launch the AdminStudio Interface from 
the Windows Start menu. 


AdminStudio Interface help is organized into the following areas: 


AdminStudio Interface Help 


2) AdminStudio Application Catalogs 


This section contains information creating and working with AdminStudio Application Catalogs. 


®) Configuring the AdminStudio Interface 


Information on customizing the AdminStudio Interface, including setting shared directories and how often 
AdminStudio checks for updates, is contained here. 


ey, Working with Tools 
J) 


As you use AdminStudio, or if you create Workflows, you need to configure tools. This includes not only AdminStudio 
tools, but external tools necessary to perform workflow tasks. 


2) Workflows and Projects 


AdminStudio contains workflow functionality, allowing you to define repeatable processes to accomplish your goals. 


?) AdminStudio Interface Reference 


This section contains an exhaustive description of each dialog, Wizard, and UI element in AdminStudio. 
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AdminStudio Application Catalogs 


The AdminStudio Application Catalog is the database where workflow, ConflictSolver (AdminStudio Professional— 
only), permissions (InstallShield AMS 2.0—only), and AMS information (InstallShield AMS 2.0—only) is stored. 


In multi-user environments, the AdminStudio Application Catalog is typically shared. The AdminStudio 
Administrator can make a shared catalog the default catalog, which results in all AdminStudio users who use the same 
shared location using the same shared Application Catalog. If the shared Application Catalog is changed, users will 
automatically open up the new shared Application Catalog. 


The AdminStudio Shared Location, which is set on the Locations tab of the Options Dialog, should refer to a network 
folder, preferably a UNC path (that is provided in the setup). It should not be set to refer fo a local folder on the client 
machine. 


@- 


In InstallShield AMS 2.0, typically only AdminStudio Administrators and a select few users will have access to create 
new Application Catalogs, upgrade Application Catalogs, or otherwise affect multiple users. 


Logging into AdminStudio for the First Time 


The first time you launch AdminStudio, you are automatically connected to the sample AdminStudio Application 
Catalog, which uses Microsoft Access. You can either learn about AdminStudio using this sample Application 
Catalog, or create a new Application Catalog for your organization. If you choose to create a new catalog, InstallShield 
strongly recommends you use an Application Catalog that uses SQL Server. 


If you are upgtading from a previous version of AdminStudio, when you first log in, AdminStudio will give you the 
option of upgrading the schema for the database. 
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Changing an SQL Server Password 


w 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To change an SQL Server password from within AdminStudio 


Launch the AdminStudio Interface. 
Connect to a Microsoft SQL Server or MSDE Application Catalog. 


Select Change Password from the Catalog menu. The Change Password dialog appears, listing your 
User Name and SQL Server name. 


Change Password 


User Name: sa 


SOL Server: testlabsql2k 


Old Password: 


New Password: 


Confirm New Password: 


In the Old Password text box, enter your current password. 


If you accessed this dialog via the Manage Users dialog, this field is disabled. 


In the New Password text box, enter a new password. 


In the Confirm Password text box, enter the password exactly as you entered it in the New Password 
text box. 


Click OK. A message appears stating that the password was changed successfully. 


Click OK. 
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In InstallShield AMS 2.0, Administrators can change the password of any user using the Manage Users dialog, which is 
displayed when you select Security from the Catalog menu. See Manage Users Dialog for more information. 


> 


The Change Password menu item is disabled for Access databases and non-SQL Server logins. 


Creating a New Application Catalog 


on 


Bi 


To create a new AdminStudio Application Catalog: 


1. Launch the AdminStudio Interface. 


2. Select Create from the Catalog menu. The Create Application Catalog dialog opens. 


Create Application Catalog 


Pas © Microsoft Access 
= 


|c: \AdminStudio Shared\\Project8.mdb 


O Microsoft SQL Server / MSDE 
= 


AdminStudio Application Catalog is required to store Projects 
and Workflows, and to store tools associated with individual = 
tasks. Specify the type, name, and location of a new 


AdminStudio Application Catalog and click Create. 


| 


3. Select the type of database you want to use for the Application Catalog: Microsoft Access or Microsoft 
SQL Server / MSDE (Microsoft SQL Server 2000 Desktop Engine). 


4. If you want this Application Catalog to be the default shared Application Catalog used in your 
organization, select the corresponding option at the bottom of the dialog. 


5. If you selected Microsoft Access for the database type, provide the name and location of the Access file 
and click Create. The new Application Catalog is named and saved as specified. 
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6. If you selected Microsoft SQL Server / MSDE for the database type, perform the following steps: 
a. Click Create to display the SQL Server / MSDE Login dialog. 


SQL Server / MSDE Login 


Server: | 


How should SQL Server verify the authenticity of the login ID? 
© with Windows NT authentication using the network login ID. 


©@) With SQL Server authentication using a login ID and password 
entered by the user. 


Login ID: | JohnSmith 


Password: [ 


Database: | 


[C] Create database as a subscriber 


b. In the SQL Server / MSDE Login dialog, select or specify the Server on which you want to create 
the Application Catalog. 


c. Specify how SQL Server or MSDE should verify the authenticity of the login—either using Windows 
NT authentication or using SQL Server authentication. If you select SQL Server authentication, 
specify the Login ID and Password to log in. 


d. Enter a name for the new Application Catalog in the Database field. 


e. If you are creating a new SQL Server database which is intended for use as a Subscriber for 
Application Catalog Replication, select the Create database as a subscriber option. 


f EEN 
\ 
| A f 
\ 
Vaai / 


Note the following: 


m You cannot create a Publication in a Subscriber database. 

m |f you choose this option, making it a Subscriber database, the Subscription Manager option 
under Replication on the Catalog menu is enabled. If you do not choose this option, making it a 
Publisher database, the Publication Manager option under Replication on the Catalog menu is 
enabled. 

m Once you have created a database, you cannot go back and edit the choice you made on this 
option. 

m Just because you select this option does not mean that this database must contain subscribed 
data or that all of its data must be subscribed. It can contain all local data or both local and 
subscribed data. 

m For more information, see Application Catalog Replication. 


f. Click OK. 
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® 


The first time AdminStudio is run, anyone can create a SQL Server database (providing they have access to a SQL 
Server and database creation rights). However, once an AdminStudio Application catalog using SQL Server / MSDE 
has been created, the database creator becomes the Application Catalog administrator, and security rights are in place 


in AdminStudio. 


Using Scripts to Create AdminStudio Application 
Catalog Databases on SQL Server 


Typically, users assigned the Administrator role in AdminStudio use Create on the Catalog menu to create a new 
Application Catalog. Then, the Administrator adds user access to this new Application Catalog using the Manage 
Users Dialog. 


However, because of security concerns, some Database Administrators may be hesitant to grant the database creation 
rights that are necessary to create an Application Catalog database using SQL Server to AdminStudio users. 
Consequently, the Database Administrator must manually create the database and provide the necessary read and 
write access for users to that database. 


AdminStudio is shipped with two database creation SQL scripts to make it easy for Database Administrators to create 
new AdminStudio Application Catalogs: 


Script Description 
AS_Schema.SQL Creates a new Application Catalog named AdminStudio. 
AMS_System_Schema.SQL Adds AMS tables. 


These SQL scripts are located in the following directory: 


[AdminStudio Directory] \Support 


The Database Administrator can run these scripts (first AS_Schema.SQL and then AMS_System_Schema.SQL) to 
create an Application Catalog named AdminStudio, which can be accessed by AdminStudio users. For InstallShield 
AMS 2.0, a default user and password is created, and the AdminStudio Administrator can log into AdminStudio and 
create users and roles. 
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Opening Existing AdminStudio Application 
Catalogs 


To open an existing AdminStudio Application Catalog: 


1. Launch the AdminStudio Interface. 


2. Select Connect from the Catalog menu. The Connect to Application Catalog dialog opens. 


Connect to Application Catalog 


Existing | Recent! 


= © Microsoft Access 
O Microsoft SOL Server / MSDE 
= 


If you want to connect to an existing AdminStudio Application 
Catalog, specify it here and click Open. 


3. In the Connect to Application Catalog dialog's Existing tab, select the type of database you want to 
open for the Application Catalog: Microsoft Access or Microsoft SQL Server / MSDE (Microsoft SQL 
Server 2000 Desktop Engine). Alternatively, select the Recent tab and select a recently-used Application 


Catalog. 


Connect to Application Catalog 


— 
| Existing | Recent | 


Catalogs 
E AdminStudio Application Sample Catalog... 
C:\AdminStudio Shared\HoweT echnology.mdb 


[C] Make this the default shared Application Catalog 
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4. If you want this Application Catalog to be the default shared Application Catalog used in your 
organization, select the corresponding option at the bottom of the dialog. 


5. If you selected Microsoft Access for the database type, provide the name and location for the Access 
file and click Open. 


6. If you selected Microsoft SQL Server / MSDE for the Application Catalog type, perform the following 
steps: 


a. Click Open to display the SQL Server / MSDE Login dialog. 


SQL Server / MSDE Login 


Server: | 


How should SQL Server verify the authenticity of the login 1D? 


© with Windows NT authentication using the network login ID. 


@ With SQL Server authentication using a login ID and password 
entered by the user. 


Login ID: JohnSmith 


Password: 


Database: | 


[C] Create database as a subscriber 


b. In the SQL Server / MSDE Login dialog, select or specify the Server where the Application Catalog 
is stored. 


c. Specify how SQL Server or MSDE should verify the authenticity of the login—either using Windows 
NT authentication or using SQL Server authentication. If you select SQL Server authentication, 
specify the Login ID and Password to log in. 


d. Browse for the Application Catalog you want to open in the Database field. 


e. Click OK. 


Specifying a Default AdminStudio Application 
Catalog 


You can set up a default Application Catalog for all AdminStudio users in your enterprise by: 


E Specifying the location of the AdminStudio Shared folder to be a shared network drive. 
and 


E Selecting an Application Catalog in that AdminStudio Shared folder to be the default Application Catalog. 
You can specify a default Application Catalog in two ways: 


m Using the AdminStudio Interface 
or 


m Manually editing the Shared AdminStudio. ini file. 
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Using the AdminStudio Interface 


To specify a default AdminStudio Application Catalog using the AdminStudio Interface: 
1. Install AdminStudio using the Setup. 


2. During installation, specify the location of the AdminStudio Shared folder to be on a shared network 
location, such as: 


\\servername\AdminStudio Shared 


3. Open AdminStudio. 


4. Select Create on the Catalog menu. The Create Application Catalog dialog appears. 


Create Application Catalog 


New | 


i= © Microsoft Access 
C:\AdminStudio Shared\Project8.mdb 


= O Microsoft SOL Server Z MSDE 


AdminStudio Application Catalog is required to store Projects 


and Workflows, and to store tools associated with individual 


tasks. Specify the type, name, and location of a new 
AdminStudio Application Catalog and click Create. 


5. Select the Make this the default shared Application Catalog checkbox. 


6. To create a new Microsoft Access database, select the Microsoft Access radio button. Then specify the 
full path name of the AdminStudio Shared folder and the name of the new database, such as: 


\\servername\AdminStudio Shared\appcatalogname.mdb 


Then click Create and skip to Step 8. 
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7. 


To create a Microsoft SQL Server / MSDE database, select the Microsoft SQL Server/MSDE radio 
button and click Create. The SQL Server / MSDE Login dialog appears. 


SQL Server / MSDE Login 


Server: | 7 


How should SQL Server verify the authenticity of the login ID? 
O With Windows NT authentication using the network login ID. 


@ With SQL Server authentication using a login ID and password 
entered by the user. 


Login ID: | JohnSmith 


Password: | i 


Database: [ : 


[C] Create database as a subscriber 


a. Specify the Server name of the SQL database. 

b. Select the With SQL Server authentication ... radio button. 
c. Enter the appropriate Login ID and Password. 

d. In the Database text box, enter a new database name. 

e. Click OK. 

Exit from AdminStudio. 


The final step is to set the location of the AdminStudio Shared folder for all enterprise users to point to 
the folder in the shared network location. This can be specified in the installation package that 
enterprise users will use to install AdminStudio. 


After installing AdminStudio, enterprise users (non-administrative) will automatically be connected to the 
default application catalog that you specified each time they open AdminStudio. 


Editing the Shared Adminstudio.ini file 


gi* 


Bi 


To specify a default AdminStudio Application Catalog by editing the Shared 
Adminstudio.ini file: 


10. Install AdminStudio using the Setup. 


11. During installation, specify the location of the AdminStudio Shared folder to be on a shared network 


location, such as: 


\\servername\AdminStudio Shared 
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12. Open the AdminStudio Shared folder in its shared network location. 
13. Open the Shared AdminStudio.ini file and insert one of the following in the [Database Settings] section: 


Microsoft Access Database: 


C[Database Settings] 
DefaultDatabase=Provider=Microsoft.Jet.OLEDB.4.0; 
Source=\\servername\AdminStudio Shared\appcatalogname.mdb 


Microsoft SQL / MSDE Database: 


[Database Settings] 
DefaultDatabase=Provider=SQLOLEDB.1;User ID=userid; 
PwD=password; Initial Catalog=nameofdatabase; 

Data Source=nameofsqlserver; 


14. The final step is to set the location of the AdminStudio Shared folder for all enterprise users to point to 
the folder in the shared network location. This can be specified in the installation package that 
enterprise users will use to install AdminStudio. 


After installing AdminStudio, enterprise users (non-administrative) will automatically be connected to the 
default application catalog that you specified each time they open AdminStudio. 


The Create and Connect options on the Catalog menu on the AdminStudio Interface are disabled for all non- 
administrative users of AdminStudio. Therefore, non-administrative users are unable to connect to a database other than 
the one you specified. 


Administrative users can change the location of the AdminStudio Shared folder on the Options dialog (accessed by 
selecting Options on the Tools menu from the AdminStudio Interface). However, Options on the Tools menu is disabled 
for non-administrative users, so they are unable to change the location of the AdminStudio Shared folder. 
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Disconnecting from the AdminStudio Application 
Catalog 


To disconnect from the currently open AdminStudio Application Catalog, select Disconnect from the Catalog menu. 
You can disconnect from an Application Catalog while you are in ConflictSolver, and also when you are in the 
AdminStudio Interface. 


When you have disconnected from an Application in ConflictSolver, the following message appears: 


ConflictSolver requires a connection to the AdminStudio Application Catalog. Select 
Connect from the Catalog menu to establish a connection. 


Upgrading Existing AdminStudio Databases 


When you attempt to open an AdminStudio 3.0, 3.01, or 3.5 Workflow or ConflictSolver database, AdminStudio 5 
prompts you to upgrade the existing database to an AdminStudio 5 Application Catalog using the Upgrade Wizard. 
The source Workflow or ConflictSolver databases can be Microsoft Access or SQL Server, and the destination 
Application Catalog can be either Access or SQL Server. 


Log files for the upgrade are created in the \ConflictSolver\Logs directory. Access databases are backed up in the 
same directory as the upgraded Application Catalog. SQL Server databases do not drop old tables from the 
Application Catalog. 


Setting Up Production and Test Environments 


There are two types of envitonments you may want to use AdminStudio within: production and test. When setting up 
a production environment, typically the administrator creates a new Application Catalog and marks it as the default 
shared Application Catalog. This creates an INI file in the AdminStudio shared directory indicating that this is the 
default Application Catalog. When other users install AdminStudio and point to the same shared location, they are 
automatically connected to that Application Catalog when they log into AdminStudio. 


However, there may be times you want to configure a test environment separate from the production environment. 
This involves a user (or administrator) creating a new Application Catalog, and then users changing the AdminStudio 
Shared Location from the Options dialog in AdminStudio to point to the new location. The users can then open the 
test Application Catalog. 
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The AdminStudio Application Catalog is primarily organized using variations on Windows Installer table names. 
These are prefixed with "csmsi" for ConflictSolver MSI tables and "csmsm" for ConflictSolver merge module table. 
For example, the MSI table "Shortcut" is represented as "csmsiShortcut" in the Application Catalog. 


3 Using the AdminStudio Interface 


Following is a complete listing of tables in Application Catalog: 


System Tables 


Table Corresponding Windows Installer Table 
cssysExtendedAttributeSchema N/A 
cssysSchemalnfo N/A 
essysTables N/A 


ConflictSolver Tables 


Table Corresponding Windows Installer Table 
cstbIPackage N/A 
cstbIGroups N/A 
cstbIGroupPackages N/A 
cstbIConflictConfiguration N/A 
cstbIConflictACE N/A 
estbIConflictPackages N/A 
cstbIConflictResults N/A 
cstbIConflictTransformList N/A 
cstbIConflictResultsDestPkgs N/A 
cstblExtendedAttributeData N/A 
estblignoreTableList N/A 
cstbIPackageHistoryLog N/A 
cstblTransformFile N/A 
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Table Name 


Corresponding Windows Installer Table 


csmsiActionText 


ActionText 


csmsiAdminExecuteSequence 


AdminExecuteSequence 


csmsiAdminUISequence 


AdminUISequence 


csmsiAdvtExecuteSequence AdvtExecuteSequence 
csmsiAdvtUISequence AdvtUISequence 
csmsiAppld Appld 
csmsiAppSearch AppSearch 
csmsiBBControl BBControl 
csmsiBillboard Billboard 
csmsiBinary Binary 
csmsiBindImage Bindlmage 
csmsiCCPSearch CCPSearch 
csmsiCheckBox CheckBox 
csmsiClass Class 
csmsiComboBox ComboBox 
csmsiCompLocator CompLocator 
csmsiComplus Complus 
csmsiComponent Component 
csmsiCondition Condition 
csmsiControl Control 


csmsiControlCondition 


ControlCondition 


csmsiControlEvent 


ControlEvent 


csmsiCreateFolder 


CreateFolder 
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Table Name 


Corresponding Windows Installer Table 


csmsiCustomAction CustomAction 
csmsiDialog Dialog 
csmsiDirectory Directory 
csmsiDrLocator DrLocator 
csmsiDuplicateFile DuplicateFile 
cesmsiEnvironment Environment 
csmsiError Error 
csmsiEventMapping EventMapping 
csmsiExtension Extension 
csmsiFeature Feature 
csmsiFeatureComponents FeatureComponents 
csmsiFile File 


csmsiFileSFPCatalog 


FileSFPCatalog 


csmsiFont Font 
csmsilcon Icon 
csmsilniFile IniFile 
csmsilniLocator IniLocator 


csmsilnstallExecuteSequence 


InstallExecuteSequence 


csmsilnstallUISequence 


InstallUISequence 


csmsilsolatedComponent 


IsolatedComponent 


csmsiLaunchCondition 


LaunchCondition 


csmsiListBox 


ListBox 


csmsiListView 


ListView 


csmsiLockPermissions 


LockPermissions 
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Table Name 


Corresponding Windows Installer Table 


csmsiMedia 


Media 


csmsiMIME 


MIME 


csmsiModuleComponents 


ModuleComponents 


csmsiModuleDependency 


ModuleDependency 


csmsiModuleExclusion 


ModuleExclusion 


csmsiModuleSignature ModuleSignature 
csmsiMoveFile MoveFile 
csmsiMsiAssembly MsiAssembly 
csmsiMsiAssemblyName MsiAssemblyName 


csmsiMsiDigitalCertificate 


MsiDigitalCertificate 


csmsiMsiDigitalSignature 


MsiDigitalSignature 


csmsiMsiFileHash 


MsiFileHash 


csmsiMsiPatchHeaders 


MsiPatchHeaders 


csmsiODBCAttribute ODBCAttribute 
csmsiODBCDataSource ODBCDataSource 
csmsiODBCDriver ODBCDriver 
csmsiODBCSourceAttribute ODBCSourceAttribute 
csmsiODBCTranslator ODBCTranslator 
csmsiPatch Patch> 
csmsiPatchPackage PatchPackage 
csmsiProgld Progld 
csmsiProperty Property 


csmsiPublishComponent 


PublishComponent 


csmsiRadioButton 


RadioButton 
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Table Name 


Corresponding Windows Installer Table 


csmsiRegistry Registry 
csmsiRegLocator RegLocator 
csmsiRemoveFile RemoveFile 


csmsiRemovelniFile 


RemovelniFile 


csmsiRemoveRegistry RemoveRegistry 
csmsiReserveCost ReserveCost 
csmsiSelfReg SelfReg 
csmsiServiceControl ServiceControl 
csmsiServicelnstall Servicelnstall 
csmsiSFPCatalog SFPCatalog 
csmsiShortcut Shortcut 
csmsiSignature Signature 
csmsiTextStyle TextStyle 
csmsiTypeLib TypeLib 
csmsiUlText UlText 
csmsiUpgrade Upgrade 
csmsiVerb Verb 
csmsisys_Columns _Columns 
csmsisys_Tables _Tables 
csmsisys_Validation _Validation 
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MSM Tables 


3 Using the AdminStudio Interface 


Table Name 


Corresponding Windows Installer Table 


csmsmActionText 


ActionText 


csmsmAdminExecuteSequence 


AdminExecuteSequence 


csmsmAdminUISequence 


AdminUISequence 


csmsmAdvtExecuteSequence AdvtExecuteSequence 
csmsmAdvtUISequence AdvtUISequence 
csmsmAppld Appld 
csmsmAppSearch AppSearch 
csmsmBBControl BBControl 
csmsmBillboard Billboard 
csmsmBinary Binary 
csmsmBindImage Bindlmage 
csmsmCCPSearch CCPSearch 
csmsmCheckBox CheckBox 
csmsmClass Class 
csmsmComboBox ComboBox 
csmsmCompLocator CompLocator 
csmsmComplus Complus 
csmsmComponent Component 
csmsmCondition Condition 
csmsmControl Control 


csmsmControlCondition 


ControlCondition 


csmsmControlEvent 


ControlEvent 


csmsmCreateFolder 


CreateFolder 
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Table Name 


Corresponding Windows Installer Table 


csmsmCustomAction CustomAction 
csmsmDialog Dialog 
csmsmDirectory Directory 
csmsmDrLocator DrLocator 
csmsmDuplicateFile DuplicateFile 
csmsmEnvironment Environment 
csmsmeError Error 
csmsmEventMapping EventMapping 
csmsmExtension Extension 
csmsmFeature Feature 
csmsmFeatureComponents FeatureComponents 
csmsmFile File 
csmsmFileSFPCatalog FileSFPCatalog 
csmsmFont Font 
csmsmicon Icon 
csmsmlniFile IniFile 
csmsmlniLocator IniLocator 


csmsmiInstallExecuteSequence 


InstallExecuteSequence 


csmsminstallUISequence 


InstallUISequence 


csmsmlsolatedComponent 


IsolatedComponent 


csmsmLaunchCondition 


LaunchCondition 


csmsmListBox 


ListBox 


csmsmListView 


ListView 


csmsmLockPermissions 


LockPermissions 
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Table Name 


Corresponding Windows Installer Table 


csmsmMedia 


Media 


csmsmMIME 


MIME 


csmsmModuleAdminExecuteSequence 


ModuleAdminExecuteSequence 


csmsmModuleAdminUISequence 


ModuleAdminUISequence 


csmsmModuleAdvitExecuteSequence 


ModuleAdviExecuteSequence 


csmsmModuleComponents 


ModuleComponents 


csmsmModuleConfiguration 


ModuleConfiguration 


csmsmModuleDependency 


ModuleDependency 


csmsmModuleExclusion 


ModuleExclusion 


csmsmModulelgnoreTable 


ModulelgnoreTable 


csmsmModulelnstallExecuteSequence 


ModulelnstallExecuteSequence 


csmsmModulelnstallUISequence 


ModulelnstallUlISequence 


csmsmModuleSignature ModuleSignature 
csmsmModuleSubstitution ModuleSubstitution 
csmsmMoveFile MoveFile 
csmsmMsiAssembly MsiAssembly 
csmsmMsiAssemblyName MsiAssemblyName 


csmsmMsiDigitalCertificate 


MsiDigitalCertificate 


csmsmMsiDigitalSignature 


MsiDigitalSignature 


csmsmMsiFileHash 


MsiFileHash 


csmsmMsiPatchHeaders 


MsiPatchHeaders 


csmsmODBCAttribute ODBCAttribute 
csmsmODBCDataSource ODBCDataSource 
csmsmODBCDriver ODBCDriver 
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Table Name 


Corresponding Windows Installer Table 


csmsmODBCSourceAttribute ODBCSourceAttribute 
csmsmODECtTranslator ODBCTranslator 
csmsmPatch Patch> 
csmsmPatchPackage PatchPackage 
csmsmProgld Progld 
csmsmProperty Property 


csmsmPublishComponent 


PublishComponent 


csmsmRadioButton 


RadioButton 


csmsmRegistry Registry 
csmsmRegLocator RegLocator 
csmsmRemoveFile RemoveFile 


csmsmRemovelniFile 


RemovelniFile 


csmsmRemoveRegistry 


RemoveRegistry 


csmsmReserveCost 


ReserveCost 


csmsmSelfReg 


SelfReg 


csmsmServiceControl 


ServiceControl 


csmsmServicelnstall 


Servicelnstall 


csmsmSFPCatalog SFPCatalog 
csmsmShortcut Shortcut 
csmsmSignature Signature 
csmsmTextStyle TextStyle 
csmsmTypeLib TypeLib 
csmsmUIText UlText 
csmsmUpgrade Upgrade 
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Table Name 


Corresponding Windows Installer Table 


csmsmVerb Verb 
csmsmsys_Columns _Columns 
csmsmsys_Tables _Tables 
csmsmsys_Validation _Validation 


OS Snapshot Tables 


Table Name 


Corresponding Windows Installer Table 


csoscFile N/A 
csosclniFile N/A 
csoscShortcut N/A 
csoscRegistry N/A 


Workflow Tables 


Table Name Corresponding Windows Installer Table 
witbIlCommandLines N/A 
wftblTemplateTasks N/A 
wftblTemplateWorkflow N/A 
wftblTemplates N/A 
wftblTools N/A 
wftblUserWorkflows N/A 
wftblWorkflowTasks N/A 
wftblGroups N/A 
wftblGroupTools N/A 
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Table Name 


Corresponding Windows Installer Table 


assysRolePermissions N/A 
assysRoles N/A 
assysRoleTools N/A 
assysUserRoles N/A 


AMS Tables 


This is a snap-in feature available only with InstallShield AMS 2.0. 


Table Name 


Corresponding Windows Installer Table 


asAMSAppRegistrations N/A 
AMS_AppAsgnRpt N/A 
AMS_AppAssignments N/A 
AMS _Application N/A 
AMS_Applicationltem N/A 
AMS_AuditTrail N/A 
AMS_Company N/A 
AMS_CompanyBU N/A 
AMS_Contracts N/A 
AMS_DataMgijorltemTpl N/A 
AMS_DataMinorltemTexiTpl N/A 
AMS_DataMinorltemTpl N/A 
AMS _Dictionary N/A 
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Table Name Corresponding Windows Installer Table 
AMS_EmailContent N/A 
AMS Issues N/A 
AMS _lItemRole N/A 
AMS_KnowledgeCore N/A 
AMS_LanguageList N/A 
AMS _LanguageLongString N/A 
AMS_LanguageStrings N/A 
AMS_LanguageSymbols N/A 
AMS_LanguageUsages N/A 
AMS Person N/A 
AMS PersonRole N/A 
AMS Policy N/A 
AMS Preference N/A 
AMS_Queries N/A 
AMS Roles N/A 
AMS_ServiceCompanyJoin N/A 
AMS _Templates N/A 
AMS_WFMgiorltemTpl N/A 
AMS_WFMinorltemTpl N/A 
AMS_UploadedFiles N/A 
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Configuring the AdminStudio Interface 


Topics in this section involve configuring and customizing how the AdminStudio interface operates. 


Viewing the QuickStart Guide 


AdminStudio includes a interactive overview of product functionality within the QuickStart Guide. This guide is 
available from the AdminStudio Start page by clicking on any of the nodes in the main graphic. The appropriate 
DemoShield demo launches, providing overview information for that particular product area. 


Tì testlabsql2k (HoweCatalog7004) - sa - InstallShield AdminStudio 


AdminStudio 


QuickStart Guide (Give Us Feedback ) 


Welcome to InstallShield AdrninStudio, the most easy-to-use and reliable solution for repackaging legacy setups, 
customizing Windows Installer packages, and resolving application conflicts. Click on a question in the graphic 
below to discover the AdminStudio solubon, or click in the canter of the image for an overview of the Application 
Migretion process. 


Do you have o legacy Do you want to cuthor 
setup you need lo convert or enhance a Windows 
into a Windows installer Installer package or 

package (MSI)? repackaged setup? 


\ =r 


Po Y Windows kaaler | dæ} AdminStudio 


a 9 ai s QuickStart 
Wina” i Guide 
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Launching AdminStudio Applications 


Individual AdminStudio applications, such as Tuner, DevStudio, or Repackager, can be launched by double-clicking 
on the tool in the Tools Gallery (available in the Start tab), or by selecting the tool from the Tools menu. 


3 


QuickStart Guide Repackager 


DevStudio 


S x 


ConflictSolver QualityMonitor 


' Ff 


Distribution Wizard Global Exclusions 
Editor 


y & 


OS Snapshot Application Isolation 
Wizard Wizard 


@ Start Projects | [BF Workflows 


If a core AdminStudio tool is not in the Tools Gallery or available from the menu, it may mean an administrator has 
restricted tool access based on user permissions. 
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Specifying the Shared Application Catalog 
Location 


oT 
8. 

To specify the location of the shared AdminStudio Application Catalog: 
1. Launch the AdminStudio Interface. 

2. From the Tools menu, select Options. The Options dialog opens. 


Options 


Locations | InstallShield Updates 


Shared AdminStudio Application Catalog: 
IC:\AdminStudio Shared\Howe Technology. mdb) Change... 


AdminStudio Shared Location: 
C:\AdminStudio Shared’, r Browse... 


Task Help Page Location: 


C:\AdminStudio Shared\Help Browse... 


Application Management System [AMS] Web site URL: 
jhttp://172.17.1.142 


3. Select the Locations tab, and enter or browse to the location for the Shared AdminStudio Application 
Catalog. 


4. Click OK to close the Options dialog. 
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Specifying the AdminStudio Shared Directory 
Location 


The AdminStudio Shared Directory (also referred to as the AdminStudio Shared Location) contains shared 
information for repackaging and conflict identification, and other AdminStudio functions. The AdminStudio Shared 
Directory contains the following: 


The Shared AdminStudio.ini file, which specifies default application catalog database settings 
ConflictSolver duplicate package identifier options 

Repackager isrepackager.ini global exclusion list 

OS Snapshot issnapshot.ini file 

ConflictSolver user-defined ACEs 

Distribution Wizard Distribution Type templates and .ini files 


If you are working in a team environment, the AdminStudio Shared Directory should be set to a centralized network 
location, accessible by all AdminStudio users at your organization, rather than on your local machine. Follow the steps 
below to specify the location of the AdminStudio Shared Directory. 


To maintain consistency when creating workflows, InstallShield recommends that you set the AdminStudio Shared 
Directory the same for each AdminStudio user. 


Q 
r 
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To specify the location of the AdminStudio Shared Directory: 
1. Launch the AdminStudio Interface. 


2. From the Tools menu, select Options. The Options dialog appears. 


Options 


Locations | InstallShield Updates | 


Shared AdminStudio Application Catalog: 


C:\AdminStudio Shared\HoweT echnology.mdb Change... 


AdminStudio Shared Location: 
/C:\AdminStudio Shared, Browse... 


Task Help Page Location: 


[C:\AdminStudio Shared\H elp 


Application Management System [AMS] Web site URL: 
‘http: //172.17.1.142 


Po (cra toy) 


3. In the Options dialog, select the Locations tab. 
4. In the Locations tab, enter or browse to the location for the AdminStudio Shared Location. 


5. Click OK to close the Options dialog. 
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Setting the AdminStudio Shared Location 


To specify the AdminStudio shared location: 
1. Launch the AdminStudio Interface. 
2. From the Tools menu, select Options. The Options dialog appears. 


Options 


Locations | InstallShield Updates 


Shared AdminStudio Application Catalog: 


[C:\AdminStucio Shared\HoweT echnolog mdb : 4 : Change... 


AdminStudio Shared Location: 
C:\AdminStudio Shared’, r Browse... 


Task Help Page Location: 


|C:\AdminStudio Shared\Help Browse... 


Application Management System [AMS] Web site URL: 
jhittp:4/172.17.1.142 


3. In the Options dialog, select the Locations tab. 
4. In the Locations tab, enter or browse to the location for the AdminStudio Shared Location. 


5. Click OK to close the Options dialog. 
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Setting the Task Page Help Location 


To specify the location of task page help: 
1. Launch the AdminStudio Interface. 
2. From the Tools menu, select Options. The Options dialog appears. 


Options 


Locations | InstallShield Updates 


Shared AdminStudio Application Catalog: 
| C\AdminStudio Shared\Howeechnology. mdb AA Change... 


AdminStudio Shared Location: 
C:\AdminStudio Shared’, Browse... 


Task Help Page Location: 


|C:\AdminStudio Shared\Help Browse... 


Application Management System [AMS] Web site URL: 
jhttp://172.17.1.142 


3. In the Options dialog, select the Locations tab. 


4. In the Locations tab, enter or browse to the Task Help Page Location, the location where task page help 
is stored. 


5. Click OK to close the Options dialog. 
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Specifying the AMS Web Site URL 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To specify the AMS Web site URL: 
1. Launch the AdminStudio Interface. 


2. From the Tools menu, select Options. The Options dialog appears. 


Options 


Locations | InstallShield Updates 


| Shared AdminStudio Application Catalog: 
| HC:\AdminStudio Shared\HoweT echnology. Change... 


AdminStudio Shared Location: 


| C:\AdminStudio Shared’, l Browse... 


Task Help Page Location: 


| C:\AdminStudio Shared\Help Browse... | 


Application Management System [AMS] Web site URL: 
(http: //172.17.1.142_ 


3. In the Options dialog, select the Locations tab. 
4. In the Locations tab, enter the Application Management System (AMS) Web site URL. 


5. Click OK to close the Options dialog. 
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Configuring How Often AdminStudio Checks for 
Updates 


To configure how often AdminStudio checks the InstallShield Web site for updates: 
1. Launch the AdminStudio Interface. 


2. From the Tools menu, select Options. The Options dialog appears. 


Options 


Locations | InstallShield Updates 


Shared AdminStudio Application Catalog: 


HC: ‘AdminStudio Shared\HoweT echnology. Change... J 


AdminStudio Shared Location: 


[C:\AdminStudio Shared an Browse... 


Task Help Page Location: 


C:\AdminStudio Shared\Help Browse... 


Application Management System [AMS] Web site URL: 
jhittp:4/172.17.1.142 
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3. In the Options dialog, select the InstallShield Updates tab. 


Options 


| Locations | InstallShield Updates | 
eos 


InstallShield AdminStudio Software Updates 


eo Use the InstallShield Update Service to ensure that 
InstallShield AdminStudio is up to date. 


Check for software updates 


| Once every 30 days 


4. In the InstallShield Updates tab, select the frequency AdminStudio will check for updates. This can be 
every 15 days, every 30 days, every 60 days, or never. 


5. Click OK to close the Options dialog. 


Configuring AdminStudio to Stay on Top 


To configure AdminStudio to stay on top of other applications: 
1. Launch the AdminStudio Interface. 


2. From the View menu, select Always on Top. 
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Switching Between Design and Execute Modes 


AdminStudio can be run in both a full-screen mode (design mode) and a condensed mode to use when running 
projects (execute mode). 


gi \ 


Bi 


To switch between design and execute modes: 
1. Launch the AdminStudio Interface. 


2. From the View menu, select Design Tabs. 


Generating a Debug Log for AdminStudio 


g` \ 


B 


To generate a debug log for AdminStudio: 


1. Use the following registry value to turn debugging on. 


[HKLM\Software\Instal1Shield\AdminStudio] DebugLogLevel="3" 


m Once this debugging is turned on, a log file will be created in the same location as the .exe file. 


m Levels O, 1, 2, 3 are supported with 3 being the highest. Default is level O. 


Docking AdminStudio on the Left of the Screen 


gi ` 


Bi 


To dock AdminStudio to the left side of the screen: 
1. Launch the AdminStudio Interface. 


2. From the View menu, select Dock Left. 
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Working with Tools 


Topics in this section involve adding, configuring, and associating tools in the Tools Gallery. 


Adding New Tools to the Tools Gallery 


To add a new tool to the Tools Gallery: 


1. From the Start tab, right-click in the Tools Gallery and select Add Tool. The Add Tool Wizard appears. 


Add Tool Wizard 


Welcome to the Add Tool Wizard. 


Using the Add New tool Wizard, you can add and 
configure tools in the AdminStudio Tools gallery. You can 
specify the executable to launch, enter command-line 
arguments for the tool, and provide an HTML file 
explaining how and when to use the tool. 
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2. On the Welcome Panel, click Next. The Tool Properties Panel appears. 


Add Tool Wizard 


Tool Properties 
Configure properties for the tool. 


Target: 


i ] 


Name in Tools Gallery: 


Command Line Arguments: 


Working Directory: 


-= 
| | Browse... 


3. On the Tool Properties Panel, provide the necessary details about the tool. Click Next. The Command- 
Line Configuration Panel appears. 


Add Tool Wizard 


Command-Line Configurations 
Provide Configurations for the specified tool. 


Each tool can have one or more command-line configurations associated with it. These 
configurations can be used as required for specific tasks. In addition to entering the command 
line, you can provide a description to identify the configuration's purpose. 


Description Command Line 


Add... Modify Delete 


4. If there are command-line options you want associated with the tool, do so from the Command-Line 
Configurations Panel. Each tool can have multiple command-line options associated with it for different 
purposes. 
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5. Click Finish. The new tool appears in the Tools Gallery and is available for use in workflows and 
projects. 


2— 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 


Editing Properties for an Existing Tool 


To edit an existing tool's properties: 


1. From the Start tab, right-click the tool in the Tools Gallery and select Properties. The Tool Properties 
Dialog is displayed. 


Tool Properties 


C:\Program Files\InstallS hield\AdminStudio\5. 5\Common\alw. exe} 


Name in Tools Gallery: Browse... 


Application Isolation Wizard 


Command Line Arguments: 


Working Directory: 


Comments: Browse... 


HTML Explanation File: 
C:\Program Files\InstallShield\AdminS tudio’5.5\Program\0409\4lWT 


D| Cows) 
ane |) | 


2. Click the Properties tab. 


| 


| 


3. Modify tool properties as necessary. 


4. Click OK to apply the changes. 
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@— 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 


Adding Command-Line Configurations to an 
Existing Tool 


To add a command-line configuration to an existing tool: 


1. From the Start tab, right-click the tool to which you want to add a configuration from the Tools Gallery 
and select Properties. The Tool Properties Dialog is displayed. 


Tool Properties 


| Properties Configuratio —s—“‘—‘“—*s—CS = 
| | 


Q Cd | 
A Application Isolation Wizard | 


Target: 
C:\Program Files\InstallS hield‘AdminStudio\5.5\Common\AlW. exe} 


Name in Tools Gallery: 
Application Isolation Wizard 


Command Line Arguments: 


Working Directory: 


Comments: 


HTML Explanation File: 


C:\Program Files\InstallShield\AdminS tudio’5. 5\Program\0409\4lWT 


| icc 
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2. Click the Configuration tab. 


Tool Properties 


Properties | Configuration 


Each tool can have one or more command-line configurations associated 
with it. These configurations can be used as required for specific tasks. In 
addition to entering the command line, you can provide a description to 
identify the configuration's purpose. 


Description Command Line 
Isolate a Window... -p '[SourcePackage]" 
Isolate aMerge... -p "[SourcePackage]" 


i | > 
a E 


3. Click Add. The Command-Line Properties Dialog is displayed. 


Command Line Properties 


Description: | | 


Command Line: | | 


4. Enter a description and the command-line configuration. 
5. Click OK to close the Command-Line Properties dialog. 


6. Click OK to close the Tool Properties dialog. 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Modifying Command-Line Configurations for an 
Existing Tool 

F 

Bi 

To edit and existing tool's command-line configurations: 


1. From the Start tab, right-click the tool in the Tools Gallery and select Properties. The Tool Properties 
Dialog is displayed. 


Tool Properties 


Properties | Configuration) 


pe 
aA Application Isolation Wizard 


Target: 
C:\Program Files\InstallS hield\AdminStudio\5. 5\Common\Alw. exe} 


Name in Tools Gallery: 


Application Isolation Wizard 


Command Line Arguments: 


Working Directory: 


Comments: 


HTML Explanation File: 
C:\Program Files\InstallShield\AdminS tudio’5.5\Program\0409\AlWT 
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2. Click the Configuration tab. 


Tool Properties 


Properties | Configuration 


Each tool can have one or more command-line configurations associated 
with it. These configurations can be used as required for specific tasks. In 


addition to entering the command line, you can provide a description to 
identify the configuration's purpose. 


Description Command Line 


Isolate a Window... -p '[SourcePackage]" 
Isolate aMerge... -p “[SourcePackage]'’ 


i | > 
a e r 


3. Select the command-line configuration you want to edit and click Modify. The Command-Line Properties 
Dialog appears. 


Command Line Properties 


Description: 


| Isolate a Windows Installer package (.msi}] 


Command Line: 


-p "[SourcePackage]" 


4. Modify the description and/or command line. 
5. Click OK to dismiss the Command-Line Properties dialog. 


6. Click OK in the Tool Properties dialog to apply the changes. 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Deleting Command-Line Configurations from an 
Existing Tool 


fan 


Bi 
To delete a command-line configuration from an existing tool: 


1. From the Start tab, right-click the tool from which you want to remove the configuration in the Tools 
Gallery and select Properties. The Tool Properties Dialog is displayed. 


Tool Properties 


Properties | Configuration} 


pe 
aA Application Isolation Wizard 


Target: 
C:\Program Files\InstallS hield\AdminStudio\5. 5\Common\Alw. exe} 


Name in Tools Gallery: 


Application Isolation Wizard 


Command Line Arguments: 


Working Directory: 


Comments: 


HTML Explanation File: 
C:\Program Files\InstallS hield\AdminStudio’5. 5\Program\0409\4l\WT 


D| Cows) 
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2. Click the Configuration tab. 


Tool Properties 


Properties Configuration 


Each tool can have one or more command-line configurations associated 
with it. These configurations can be used as required for specific tasks. In 


addition to entering the command line, you can provide a description to 
identify the configuration's purpose. 


f Description Command Line 


Isolate a Window... -p "[SourcePackage]" 
Isolate aMerge... -p "[SourcePackage]" 


M | E 
m E 


3. Select the configuration you want to remove and click Delete. 


4. Click OK to close the Tool Properties Dialog. 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Associating Tools with Tasks 


To associate a tool with a task: 


Click the Workflows tab in the Interface. 
In the Workflows tree, expand a Workflow to display all of its tasks. 


From the Workflows tree, select the task with which you want to associate the tool. The Task Properties 
are displayed. 


tè HoweTechnology.mdb - InstallShield AdminStudio 
|| Catalog View Tools Help 
|Oa|M|#|!|+ re + /Oe 


All Workflows | E Select Repackaging Method 
— = — Task Properties 


+) |G] 1. Package Evaluation 
| [2 


2. Repackage a Legacy Applic. Tool F 
(Properties... erties... 
a B Prepare a test machine with cle Semz p 


e Confirm that AdminStudio i Tool Configuration | <None> ] 


5j & Run Repackaging Wizard to Ca 
4 pt Leda -> Repadiadi = Help File À 

= È Specify Product Informatio 

e Specify legacy setup n 

Specify command-line 

È Enter the Product Narr 

È Enter the Product Vers 


Sg Enter legacy setup ma 
Specify server director 


< | > 
| ® Start | G] Projects Workflows 


http://www. installshield.com/ 


Notes 


From the Tool list, select the tool you want to associate with the task. If the necessary tool is not listed, 
select <New Tool...> from the list to add the tool. 


In the Tool Configuration list, select the configuration you want to use with the tool. If the configuration 
is not listed, click Configure to create the new configuration. 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Running Associated Tools in Projects 


To run a tool associated with a task: 


1. Select the Projects tab from the Interface. 
2. Expand a Project in the Projects tree to display all of its tasks. 


3. Right-click the task with which the tool is associated and select Run Task from the context menu. 


tè HoweTechnology.mdb - InstallShield AdminStudio 
|| Catalog View Tools Help 
JO a |ml#|t|+re 4 


All Projects p ¥Yerify that the source media is available 
Project Task Properties 


=|) 1. Package Evaluation 
E È verify that the migration request is complete Tool Description Application Isolation Wizard 
Verify that the source media (jussiielalieems = 
e Perform pre-installation ona "ew Project Ctrl+P C:\Program Files\InstallShield\AdminStudio\S.5\Common\alw.exe 
0O & Verify that the setup wor Delete Project De 
È Verify that the instelatiot pa 
Determine if the application is an + 
e Suggest repackaging for legacy setups 
È Suggest tuning for MSI packages 


a 
AdminStudio InstallSt~ 


Task Help Page 


Provide information and/or instructions involving this task, and replace this default 


< | < 
2 start G) Projects Workflows 


Done 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Deleting Existing Tools 


To delete an existing tool from the Tools Gallery: 
1. From the Start tab, right-click the tool you want to delete from the Tools Gallery and select Delete. 
H A 


OS Snapshot Application Isolation 
wizard Wizard 


Add Tool Insert 
Delete Del 


Launch Tool 
Properties 


® Start Projects Workflows 


2. Confirm the deletion. 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Limiting Tool Accessibility 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To limit access to a specific tool (either an AdminStudio tool or a user-defined tool): 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
b AsAdmin ASAdmin Administrator 


% dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 
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3. From the Manage Users dialog, click Manage Roles. The Manage Roles dialog opens. 


Manage Roles 


Roles: 


| Role 


R Administrator 


BY aaar 


Permissions For ‘Author’: 


Permissions 

Edit Workflow Properties 
Delete Workflow 
Create Workflow 

View Workflow Tab 
Edit Project Properties 
Delete Project 

Create Project 

Launch Tool 

Edit Tool Properties 
Delete Tool 


K K K K KKK KKK 


Type 
workflow 
workflow 
workflow 
workflow 
workflow 
workflow 
workflow 
workflow 
workflow 
workflow 


v 


4. On the Manage Roles dialog in the Roles area, select a role for which you do not want to provide 


access to a specific tool. The Permissions for the selected Role are listed. 


5. In the Permissions list, clear the box to the left of the tool that you want to restrict access to for the 


selected Role. 


6. Repeat for any additional roles you want to limit access. 


7. Click OK to close the Manage Roles dialog. 


8. Click OK to close the Manage Users dialog. Users with the affected roles assigned to them will no 


longer have access to the tool. 
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Workflows and Projects 


Workflows, which can be created and modified from the Workflows tab, are the basis for all projects in AdminStudio. 
These workflows consist of defined tasks, with which instructions (in the form of HTML files) and tools can be 
associated. Users can then create projects based on these workflows, and execute them—following the specific steps 
defined in the workflow. This allows you to create specific, repeatable procedures to accomplish your application 
migration goals. 


O 


If you update a workflow, all projects based on that workflow will reflect the changes made to the workflow. 
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Creating and Editing Workflows 


Workflows serve as templates on which products are based. Typically, only a few individuals create workflows, while 
others create projects and execute the projects to accomplish the workflow goal. 


Creating New Workflows 


To create a new workflow: 


1. Click the Workflows tab in the Interface. The Workflows tab appears. 


t? testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 
| Catalog View Tools Help 
Je a|mla\t|+r+> log 


All Workflows | 


)-[] 1. Package Evaluation 
(+) |G] 2. Repackage a Legacy Application 


AdminStudio InstallShiel 


Task Help Page 


Provide information and/or instructions involving this task, and replace this default page 
with your new HTML page. 


Objective: 


State an objective for this task. Typically, this should be a one or two sentence 
< 


® Start f2)Projects [E] Workflows 
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2. Right-click in the Workflows tree pane and select New Workflow. 


All Workflows v | 


(+) (@] 1. Package Evaluation | 


ogei 2. Repackage a Legacy Applica Ni 


New Task Insert 
Delete Del 
Rename F2 


A new Workflow is listed. 


All Workflows 


#)-[G] 1. Package Evaluation 
(+) E] 2. Repackage a Legacy Application 
Gl m 


3. Provide a name for the workflow. 


Renaming Workflows 


To rename an existing workflow: 
1. Select the Workflows tab in the Interface. 


2. Right-click the workflow you want to rename and select Rename from the context menu. 


All Workflows 


+O] 1. Package Evaluation 
+) |G] 2. Repackage a Legacy Application 


z 
Sis conieranay New Workflow Ctr 


New Task Insert 


Delete Del 


Rename 


ove Rignt Ctrl+Shift+Rig 


3. Provide a new name for the workflow. 
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Filtering Workflows 


To display a specific workflow: 
1. From the Interface, click the Workflows tab. 


2. From the drop-down menu above the Workflows tree, select the workflow you want to display. 


All Workflows 
All Workflows 


1, Package Evaluation 
2, Repackage a Legacy Applicatio 


Deleting Workflows 


To delete an existing workflow: 


1. Click the Workflows tab in the Interface. 


2. From the Workflows tree, right-click the workflow you want to delete and select Delete from the context 
menu. 


All Workflows v | 


G| 1. Package Evaluation 
G| 2. Repackage a Legacy Application 


Elf 3. Conflict Analysi 


re] 
ga 


New Workflow Ctrl+W 
New Task Insert 


Delete 


Rename F2 


3. Confirm the deletion by clicking Yes in the resulting dialog. 
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Creating New Tasks 


To create a new task 
1. Select the Workflows tab in the Interface. 


2. Right-click the workflow to which you want to add the task and select New Task. Alternatively, right 
click on a task and select New Task to create a subtask. 


All Workflows 


+-[O| 1. Package Evaluation 
-O| 2. Repackage a Legacy Application 


f=) 3. Conflict Analysis a 


New Workflow Ctrl+W 


Delete Del 
Rename F2 
ove Up trl+Shift+Up 
hove Dow Ctrl+-Shift+Down 
ove Left trl+Shift+Left 


All Workflows E EaS 
Task Properties 
1. Package Evaluation ask Propertie 


+) 


(+) [GQ] 2. Repackage a Legacy Application Tool 7 
= wv | |Properties... 
=) [B] 3. Conflict Analysis eh ke [Propertes...] 
New k40 -7 
& een Tool Configuration | <None> bá 
Heb rie al 
Notes 


3. Enter a name for the new task. 


4. Modify properties for the task. 
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Modifying Task Properties 


To modify properties for an existing task: 


1. Click on the Workflows tab. 


2. From the Workflows tree, select the task you want to modify. The Task Properties view for the selected 


task is displayed. 


tè testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 


| Catalog View Tools Help 


DER) 


joa lm|*|t|+re+\oe| 


All Workflows v Vz Launch the Repackager 


Sg After legacy setup completion, w A 
Perform post-installation configur Tool 
È Click Process and wait For the Re, 
È Once the Repackaging Wizard is + 
(9 Build the msr 
Launch the Repackager 
Open an existing project, browse 
È Review the Package Information 
Verify the corporate template (IS 
Review the Captured Files, Regis 
Build the MSI Package (F7) 


eg 
3 
È Verify that the conversion proces iJ 
eg 
eg 


Tool Configuration 


Help File 


Notes 


Save the Repackager project 
Exit the Repackager 


Start | G) Projects [£] workflows 


Task Properties 


Repackager 


<None> 


3. Change Task Properties as necessary for the task. 
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Creating Notes for a Task 


To create notes for a task: 
1. Select the Projects tab in the Interface. 


2. From the Projects tree, select the task to which you want to add notes. The Project Task Properties view 
appears for the selected task. 


tè testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 


|| catalog View Tools Help 
|o a |m] + t|/+te >@E | 


All Users Vz Suggest repackaging for legacy setups 
Project Task Properties 
ASAdmin 
=; sa 


Fl) 1. Package Evaluation 

H e Verify that the migration request is comp Tool Location 
& Verify that the source media is avail 
È Perform pre-installation on a clean te 
& Verify that the setup works on t Notes 
È Verify that the installation instru 
=) CO} Determine if the application is an MSI par 

Suggest repackaging for legacy set 
È Suggest tuning For MSI packages 


Tool Description 


Command Line 


< ] | > 


@® start G] Projects Workflows 


3. Enter notes in the Notes field. 


You can also add notes to a task in the Workflows tab. If you do, all projects based on that workflow will use the notes 
you enter as the default notes for the specific task. 


There is a 255 character limit on notes. 
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Renaming Tasks 


To rename an existing task: 
1. Select the Workflows tab in the Interface. 


2. Right-click the task you want to rename and select Rename from the context menu. 


All Workflows v 


oi Enter the Product version (only xx. yy A 
È Enter legacy setup manufacturer in tt 
ig Specify server directory to store capt 

Click Start to begin repackagm 


New Workflow Ctrl+\W 


Install the application by runnir 
New Task Insert 


oa After legacy setup completion, 
E Perform post-installation confid Delete Del 
È Click Process and wait for the F 


Rename F2 
B Once the Repackaging Wizard i 
=| 3 Build the MSI Move Up Ctrl+-Shift-+Up 
È Launch the Repackager Move 1 rl+Shift+Do' 


ing Open an existing project, brow Move Left Ctrl+-Shift+Left 
E Review the Package Informatic Move Right  Ctrl+Shift+Right 


3. Provide a new name for the task. 


Reordering Tasks 


ee 


To change the task order: 


- Select the Workflows tab in the Interface. 


2. In the Workflows tree, select the task you want to move. 


3. From the toolbar, click Move Up or Move Down to change the order in which tasks are performed. 
Click Move Right to make a task a subtask of another task; click Move Left to promote a task. 


tes 


4. Repeat the previous steps as necessary. 
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Associating Help Files with Tasks 


gi 


Bi. 
To associate a help file with a task: 


1. Click the Workflows tab in the Interface. 


2. From the Workflows tree, select the task with which you want to associate the help file. The Task 
Properties view appears for the selected task. 


tè testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 


| Catalog View Tools Help 


lo a|m|*|t|++¢>+\/@e| 


All workflows v g „ Suggest repackaging for legacy setups 


Task Properties 
E 1. Package Evaluation a i 


S] & Verify that the migration request is complete E Tool - 
<None> Properties... 
È verify that the source media is available ales J [Properties...] 


H Perform pre-installation on a clean test me — 3 7 
4 ng Verify that the setup works on the tar EE | <None> 
Verify that the installation instructions — ] 
= B Ae i if the application is an MSI package help ite ( Browse J ll 
Suggest repackaging for legacy setups 
È Suggest tuning for MSI packages 
| 2. Repackage a Legacy Application 
S] e Prepare a test machine with clean Target OS it 
[9 Confirm that AdminStudio is not installed c 
=) Sg Run Repackaging Wizard to Capture Legacy 5 
ng Select Tools -> Repackaging Wizard, click z 


Select Renarkaninn Methnad 


< j | 
I Start 2) Projects [E] Workflows 


Notes 


> 


3. In the Help File field, enter the name and location of the help file, or click Browse and navigate to it. 


4. The help file can either be local, or you can use a URL (for example, 
http://www.mycompany.com/myURL.htm). 


5. You can also click the Edit HTML button to the right of the Browse button to open a default HTML page 
in an HTML editor as a starting point. 


[Lal 


Help files must be in HTML format. 
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Deleting Tasks 


To delete an existing task: 
1. Select the Workflows tab in the Interface. 


2. In the Workflows tree, right-click the task you want to remove and select Delete. 


All Workflows v 


E 1. Package Evaluation A 
= B Verify that the migration request is complete A 
e Verify that the source media is available 

=I {> Perform pre-installation on a clean test mz 

È Verify that the setup works on the tar 

oi Verify that the installation instructions 

E e Determine if the application is an MSI package 
Suggest repackaging for le 
B Suggest tuning For MSI pac 
= 2. Repackage a Legacy Applici 
B B Prepare a test machine with cle 
E Confirm that AdminStudio i 


aM 


New workflow Ctrl+W 
New Task Insert 


Rename F2 
IS e Run Repackaging Wizard to Ca) — 


Select Tools -> Repackagin Move Up Ctrl+Shift+Up 
ing Select Repackaging Method Move Down = Ctri+Shift+Down 
| oi Specify Product Informatio) Move Left Ctrl+-Shift+Left 
È Specify legacy setupn| Move Righ Ctrl+Shift+Right 


3. From the resulting dialog, click Yes to confirm the deletion. 
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Adding New Tools from the Workflows Tab 


To add a new tool to the Tools list from the Workflows tab: 
1. Click the Workflows tab in the Interface. 


2. From the Workflows tree, select the task with which you want to associate the new tool. The Task 
Properties view appears for the selected task. 


tè testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 
|| Catalog view Tools Help 


|e a|m]|+ ERZENI 


All Workflows Vz Suggest repackaging for legacy setups 
Task Properties 


= 1. Package Evaluation 


= e Verify that the migration request is complete Tool = 
<None> 


Sa Verify that the source media is available 
B Perform pre-installation on a clean test me — $ 5 
# e Verify that the setup works on the tar Pec coonies ston shone? (Configure...] 
Verify that the installation instructions — 
| B iA if the application is an MSI package paine (Browse... ] l 
Suggest repackaging for legacy setups 
È Suggest tuning for MSI packages 
= 2. Repackage a Legacy Application 
=) B Prepare a test machine with clean Target OS ii 
oa Confirm that AdminStudio is not installed c 
5j B Run Repackaging Wizard to Capture Legacy 5 
& Select Tools -> Repackaging Wizard, click 
GL Select Renarkanina Method 


< | 
@ start | G)projects [E] workflows 


Notes 


v 


>) 
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3. From the Tool list in the Task Properties view, select <Add Tool ...>. The Add New Tool dialog opens. 


Add New Tool 


Target: 


Name in Tools Gallery: 


Command Line Arguments: 


Working Directory: 


Comments: 


HTML Explanation File: 


[Z] Add to Tools Gallery lal 
me 


4. In the Add New Tool Dialog, enter properties about the tool. 
5. Click OK. 


Creating and Using Projects 


Projects, which are based on existing workflows, are the procedures followed to accomplish a set goal. Projects may 
include instructions describing what to do, and perhaps links to tools necessary to perform tasks. They also allow you 
to provide notes to help document issues that may arise during a project. 


9 


If you update a workflow, all projects based on that workflow will reflect the changes made to the workflow. 
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Creating Workflows with the New Workflow Project Wizard 


To create a workflow using the New Workflow Project Wizard: 
1. Launch AdminStudio. 


2. Click the Projects tab. 


3. Right-click in the Projects tree and select New Project. 


New Project Ctrl+P 
Delete Project Del 


Run Task 


The New Workflow Project Wizard launches. 


New Workflow Project Wizard 
Welcome to the New Workflow Project Wizard. 
This wizard creates a new project based on an existing 


workflow. Multiple projects can be based on a workflow, 
and each project begins as a copy of that workflow. 


mre mre 
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4. From the Welcome Panel, click Next. The Workflow Selection Panel appears. 


New Workflow Project Wizard 


Workflow Selection 
Select the workflow on which you want to base your project. 


A = 


een) 2. Repackage 3. Conflict 
erie aLlegacy å... Analysis 


Provide a name for the new project: 


1. Package Evaluation 


(tse Jue) (tare) (Hoe) 


5. From the Workflow Selection Panel, select the workflow on which you want to base the new project. 


6. Provide a name for the new project and click Next. The Source Package panel appears. 


New Workflow Project Wizard 


Source Package 
Provide the name and location of the source package. 


Specify the name and location of the source package used in this project [if required): 


| | | J 


i ) The source package and directory are stored in the SourcePackage variable, and 


represents the source file for the workflow. The SourcePackage variable can be used 
when creating tool configurations in AdminStudio. 


For repackaging workflows, the source package is typically a Setup.exe file. Other 
workflows may require a Windows Installer package [.msi] as a starting point. 


Altermatively, a simple workflow that involves editing text in a Notepad file may use a txt 
file for the source package. 


(cae Juma) Cc ] (Hop) 


7. From the Source Package Panel, specify the name and location of the source package used in this 
project. Alternatively, click Browse to navigate to it. 
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8. Click Next. The Target Directory and Filename panel appears. 


New Workflow Project Wizard 


Target Directory and Filename 
Specify the output directory and filename. 


Specify the directory in which you want to store all files associated with this project. If multiple 
users will work on this project, consider using a network location. 


Target Directory: 


[C:\AdiminStudio Share {| 


Specify the name you want to use for project task output. Depending on the task you are 


performing, the appropriate file extension is added to this value. For example, if you are 
repackaging an application, the Repackager project will be named MySetup.irp. 


Target File Name: 


. 
] ) If a target directory or target file name is required, you must enter it before proceeding. 


Ce Cie) Cores) (ae) 


all files associated with this project. 


11. Click Finish. The new Workflow is now listed. 


3 Using the AdminStudio Interface 


9. From the Target Directory and File Name Panel, specify the Target Directory in which you want to store 


10. In the Target File Name field, provide a name for the output file. Depending on the task being 
executed, the appropriate extension will be added to the file name. 


In InstallShield AMS 2.0, there is an additional panel after the Target Directory and File Name panel: the 
Project Assignment Panel. Administrators can assign projects to users from this panel. 


New Workflow Project Wizard 


Project Assignment 
Assign the project to user. 


Select the user who will be responsible for this project. The project will appear under the user's 
name in the Projects tab. 


AdminStudio Application Catalog Users: 


Name Login Name 
& ASAdmin ASAdmin 


a dbo sa 


Ce ree) Cones) (ie) 
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To display a specific project: 
1. From the Interface, click the Projects tab. 


2. From the drop-down menu above the Projects tree, select the project you want to display. 


All Projects 
All Projects 


1. Package Evaluation 
2, Repackage a Legacy Application 
3. Conflict Analysis 


In InstallShield AMS 2.0, Administrators can also filter projects by user. 


Executing Projects 


To execute a project: 
1. From the Interface, click the Projects tab. 


2. Display the project you want to execute. If you want to only display that project, use the filter above the 
Projects tree. 


3. Click the first task in the project. 
4. Perform the task. 
5. When finished with the task, click the box to the left of the task. 


E 1. Package Evaluation 
B- M È Verify that the migration request is complete 
v e Verify that the source media is available 
= oi Perform pre-installation on a clean test machine 
oO e Verify that the setup works on the target OS 
È Verify that the installation instructions and options are adequate 
= & Determine if the application is an MSI package or a legacy setup 
ing Suggest repackaging for legacy setups 
og Suggest tuning for MSI packages 
(+) 1, Package Evaluation Accounting 


6. Repeat for subsequent tasks in the project. 
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Running Associated Tools in Projects 


To run a tool associated with a task: 
1. Select the Projects tab from the Interface. 
2. Expand a Project in the Projects tree to display all of its tasks. 


3. Right-click the task with which the tool is associated and select Run Task from the context menu. 


tè HoweTechnology.mdb - InstallShield AdminStudio 
| Catalog View Tools Help 
eal|mls|t|++++\0e| 


All Projects v | _ ¥erify that the source media is available 
Project Task Properties 


= 1. Package Evaluation 
= COB Verify that the migration request is complete | Tool Description Application Isolation Wizard 


Verify that the source media (jssiieelalieemes 
New Project Ctrl+P C:\Program Files\InstallShield\AdminStudio|S.S\Common\Alw exe 


Delete Project Del 


È Perform pre-installation on a 
& Verify that the setup wor 
È Verify that the installstiot Fae 
og Determine if the application is an 

È Suggest repackaging for legacy setups 

È Suggest tuning for MSI packages 


AdminStudio 


Task Help Page 


Provide information and/or instructions involving this task, and replace this default 


< | < 


A Start G) Projects workflows 


In AdminStudio, tools are any external application or file that you can launch from a workflow or project. This typically 
is an application, but can be a simple document or batch file necessary to completing the project. 
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Deleting Projects 


gi à y 

g 7 

To delete an existing project: 

1. Click the Projects tab in the Interface. 


2. From the Projects tree, right-click the project you want to delete and select Delete Project from the 
context menu. 


Emel) 1. Package Evaluatieg 


F a) 1, Package Evaluat New Project Ctrl+P 


Delete Project Del 


3. Confirm the deletion by clicking Yes in the resulting dialog. 


Saving Workflow and Project Changes 


Because AdminStudio uses a database (the Application Catalog) to store information involving Workflows and 
Projects, all changes are stored immediately. There is no need to "save" your modifications; AdminStudio performs 
this automatically. 


Workflow Project Example: Using the New 
Workflow Project Wizard 


The following basic example covers creating a workflow and project which takes advantage of command-line 
functionality available in AdminStudio. 


Prior to creating projects, you must create a workflow on which to base the project. This workflow might involve few 
steps, or it might cover as broad of a task as repackaging a legacy setup, editing it in DevStudio, customizing it in 
Tuner, performing application isolation, identifying and resolving conflicts, distributing it, and entering information 
about it into a third-party tracking system. 


In this example, you are going to create a basic workflow involving two steps: repackaging a legacy setup and opening 
the resulting DevStudio project. 


InstallShield Software Corporation © 2004 88 


AdminStudio 5.5 User Guide 3 Using the AdminStudio Interface 


Creating a New Workflow 


To create a new workflow: 
1. Launch AdminStudio. 


2. Click the Workflows tab in the Interface. The Workflows tab appears. 


22 testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio DER) 
Il Catalog View Tools Help 


\o & |m| #| 3 |\+ re 
All Workflows 1. Package Evaluation 


Workflow Properties 
| [G] 1. Package Evaluation TOPSIN 
+) {| 2. Repackage a Legacy Application 


AdminStudio InstallShiel~ 


Task Help Page 


Provide information and/or instructions involving this task, and replace this default page 
with your new HTML page. 


Objective: 


State an objective for this task. Typically, this should be a one or two sentence 
< 


® start J fA) Projects [E] workflows 


3. Right-click in the Workflows tree pane and select New Workflow. 


All Workflows v 
(+) [| 1. Package Evaluation 
fo =) § 2. Repackage a Legacy Applical New Workflow Ctri+w 
| 
New Task Insert 
Delete Del 
Rename F2 


Ctrl+Shift+Left 


Ctrl+Shift+Right 


A new Workflow is listed. 


All Workflows 


+) 


G| 1. Package Evaluation 
A| 2. Repackage a Legacy Application 


f) | lew Workflows 


BE 
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4. Name the workflow My Workflow Example. 


5. Right-click My Workflow Example and select New Task. 


All Workflows ~] 


+- [O| 2. Repackage a Legacy Application 


Eji My Workflow E 
aa ty Workflow Exome New Workflow Ctrl+W 
New Task Insert 


Delete Del 
Rename F2 


6. Name the task Repackage a Legacy Setup. 


7. With the Repackage a Legacy Setup task selected, from the Task Properties pane, select Repackager 
from the Tool menu. This associates Repackager with this task. 


t? testlabsql2k (HowePublisher2004) - sa - InstallShield AdminStudio 
| Catalog View Tools Help 
|O8|m|*|t|+ +++ |Oe) 


All Workflows v] p Repackage a Legacy Setup 
y - S Task Properties 


1. Package Evaluation 
2. Repackage a Legacy Application [ 
a My Workflow Example | <None> w | |Properties... 
B Repackage a Legacy Setup <New Tool... > 


Tool Configuration |<None> 


Application Isolation Wizard 
ConflictSolver 


Browse... F 


Help File 


Notes [Global Exclusions Editor 
OS Snapshot Wizard 


® Start ] (2) Projects Workflows 


8. Change the Tool Configuration to Repackage a legacy setup. This associates a predefined command 
line (app "[SourcePackage]" -o "[TargetDir]" -pp "[TargetFileName]") with this task. 


9. Right-click My Workflow Example and select New Task. 
10. Name the task Open the Repackaged Setup. 


11. With Open the Repackaged Setup selected, from the Task Properties pane, select DevStudio from the 
Tool menu. This associates DevStudio with this task. 


12. Change the Tool Configuration to Edit a DevStudio project created with Repackager. This associates a 
predefined command line (-"[TargetDir]\[TargetFileName].ism") with this task. 
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Creating a Project Based on the Workflow 


To create a project based on your new workflow: 


1. Click the Projects tab. 


2. Right-click in the Projects tree and select New Project. 


lew Project Ctrl+P 
$ m New Projec Ctrl+P 
Delete Project Del 


Run Task 


Welcome to the New Workflow Project Wizard. 


This wizard creates a new project based on an existing 
workflow. Multiple projects can be based on a workflow, 
and each project begins as a copy of that workflow. 


ere mre 
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3. From the Welcome Panel, click Next. The Workflow Selection Panel appears. 


New Workflow Project Wizard 


Workflow Selection 
Select the workflow on which you want to base your project. 


1. Package 2. Repackage AMR 
Evaluation  aLegacy A... Example 


Provide a name for the new project: 


My Workflow Example 


(cat neo | (tes) (Hop) 


4. From the Workflow Selection Panel, select My Workflow Example as the workflow on which you want 
to base the new project. 


5. Name the new project My Sample Project and click Next. The Source Package panel appears. 


New Workflow Project Wizard 


Source Package 
Provide the name and location of the source package. 


Specify the name and location of the source package used in this project (if required): 


| z] Ceme) 


e The source package and directory are stored in the SourcePackage variable, and 
J) represents the source file for the workflow. The SourcePackage variable can be used 
when creating tool configurations in AdminStudio. 


For repackaging workflows, the source package is typically a Setup.exe file. Other 
workflows may require a Windows Installer package [.msi] as a starting point. 
Alternatively, a simple workflow that involves editing text in a Notepad file may use a txt 
file for the source package. 


(cat Ji neo | (exes) (Hop) 


6. From the Source Package Panel, click Browse and navigate to the <AdminStudio 
Directory>5.5\Tutorial\Repackager\PackageForTheWeb 3 directory. 


7. Select PackageForTheWeb3.exe and click Open. This value (the directory and package name) are 
stored in the SourcePackage variable, which is used by the command line in Repackager set when you 
created the workflow. 
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8. Click Next. The Target Directory and File Name Panel opens. 


New Workflow Project Wizard 


Target Directory and Filename 
Specify the output directory and filename. 


Specify the directory in which you want to store all files associated with this project. If multiple 
users will work on this project. consider using a network location. 


Target Directory: 


C:\AdminStudio Shared\test\\Workflow Example v 


Specify the name you want to use for project task output. Depending on the task you are 
performing, the appropriate file extension is added to this value. For example, if you are 
repackaging an application, the Repackager project will be named MySetup.irp. 


Target File Name: 
(WorkflowProjectEx i | 


e. 
JL) Ifa target directory or target file name is required, you must enter it before proceeding. 


9. From the Target Directory and File Name panel, specify the directory where you want to store files 
associated with your project. For this example, use C:\AdminStudio Shared\Test\WorkflowExample 
This value is written to the TargetDir variable used in the command line set for DevStudio when creating 
the workflow. 


10. Set the Target File Name to WorkflowProjectEx. This value is written to the TargetFileName variable 
used in the command line set for DevStudio when creating the workflow. 


11. Click Finish. The new Workflow Project is now listed. 


If you have purchased InstallShield AMS 2.0, the Next button appears on the Target Directory and File Name panel 
instead of a Finish button. Click Next fo proceed to the Project Assignment Panel, where you can select the user who 
will be responsible for this project. Then click Finish to complete the creation of the new workflow. 
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Running the Workflow 
(™ 


To run the workflow: 
1. Expand the workflow My Sample Project in the Projects tree. 


2. Right-click the task Repackage a Legacy Setup and select Run Task. 


All Projects v 


E My Sample Project 
s Repackage a Legacy Setup 
WW Open the Repackaged Setup 
E My Workflow Example 
Dee Repackage a Legacy 
W Open the Repackagi 


New Project Ctrl+P 
Delete Proje el 


= < 


When Repackager launches, it reads the value SourcePackage to determine the file to repackage. It 
also reads TargetDir and TargetFileName to determine where to place the output and what to call the 
output file. 


3. After completing the steps above, right-click on the second step in the project and run the associated 
tool. DevStudio launches, and opens the project file (.ism) created by Repackager. 


Summary 


This is just a brief example of how AdminStudio tools can be made aware of each other during a project. When 
crafting workflows, create command lines to streamline your projects. 
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Workflows, Projects, and Permissions 


This is a snap-in feature available only with InstallShield AMS 2.0. 


AdminStudio Interface functionality (including workflows, projects, and the Tools Gallery) is directly influenced by 
user authorization and permissions in InstallShield AMS 2.0. For example, Administrators can see all users and 
projects assigned to those users in AdminStudio. In the case of NT Groups, Administrators can see individual 
members of those groups in the Projects tab. Further, Administrators can assign projects to users when running the 
New Workflow Project Wizard. 


An example of how permissions affect workflows and projects is the display of the Workflows tab, which requires the 
View Workflow Tab permission. Likewise, only users with the Create Project permission can create projects. Even if 
you have permission to view and create workflows, you can only associate tools which you are permitted to use with 
tasks you create. If you are executing projects, you can only launch tools you have permissions to use, regardless of 
whether they are associated with a task in the workflow. 
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AdminStudio Interface Reference 


AdminStudio Menus and Toolbar 


The following commands and toolbar buttons are available in the AdminStudio Interface. 


Menu Command Shortcut Button Description 

Catalog Connect Ctrl+O B Displays the Connect to Application Catalog Dialog, 
where you can open an existing Microsoft Access or 
Microsoft SQL Server / MSDE Application Catalog 
database. 

Catalog Disconnect Ctrl+D Closes the currently open Application Catalog. 

Catalog Replication Ctrl+R Use to access the SQL Server Application Catalog 


Replication feature. These menu items are selectively 
enabled depending on whether the current user is 
connected to an SQL Server database and has been 
assigned sysadmin privileges in SQL Enterprise Manager 
on that database server. If the open database is a 
Subscriber database, the Subscription Manager option 
will be enabled, and if it is a Publisher database, the 
Publication Manager option will be enabled. 


Catalo Create Ctrl+N Displays the Create Application Catalog Dialog, where 
g Play pp g g 
you can create a new Microsoft Access or Microsoft SQL 
Server / MSDE Application Catalog database. 


Catalog Security Alt+C+S Opens the Manage Users Dialog, which allows you to 
add or remove user access to the AdminStudio 
Application Catalog, change a user's SQL Server 
password, and assign roles to users. Each role has 
associated permissions, so the role assigned to a user 
defines the tasks the user can perform in AdminStudio. 
(Manage Users is a snap-in feature only available with 
InstallShield AMS 2.0.) 


Catalog Change Alt+C+P Displays the Change Password Dialog, which allows the 
Password current logged-in user to change their SQL Server login 
password from within AdminStudio. (Change Password 

is a snap-in feature available only with InstallShield AMS 


2.0.) 
Catalog User Alt+C+U 8 Displays the User Properties Dialog, which allows any 
Properties — user to view their current roles and permissions in 
AdminStudio. 
Catalog Exit Alt+C+X Exits AdminStudio and returns you to the Windows 
desktop. 
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Menu Command Shortcut Button Description 

View Toolbar Alt+V+T Toggles the Toolbar. 

View Status Bar Alt+V+S Toggles the Status Bar. 

View Design Tabs Alt+V+D = Toggles Project Design Mode (full-screen) and Execute 
Mode (minimized). 

View Always On Alt+V+A + When checked, the AdminStudio Interface remains on 

Top top of all other windows. 

View Dock Left Alt+V+L Moves your AdminStudio Interface to the top left hand 
corner of your screen. 

Tools Check for Alt+T+U Accesses the InstallShield Update Service to determine if 

Updates there any updates or messages available for 
AdminStudio. 

Tools Options Alt+T+O Displays the Options Dialog, from which you can 
configure the location of shared resources and the 
frequency AdminStudio checks for updates to 
AdminStudio. 

Help Contents Alt+H+C D Launches the online Help Library and displays the 
Contents tab. 

Help Index Alt+H+I a) Launches the online Help Library and displays the Index 
tab. 

Help Search Alt+H+S él Launches the online Help Library and displays the Search 
tab. 

Help Support Alt+H+U Connects to the InstallShield Support Central Web site. 

Central 
Help InstallShield AlttH+M Connects to the InstallShield Community. 
Community 
Help ReadMe Alt+H+R Displays the AdminStudio ReadMe file. 
Help Feedback Alt+H+F Connects to an online form, through which you can 
provide feedback about AdminStudio. 
Help InstallShield Alt+H+W wo Connects to the InstallShield Web site. 
on the Web 

Help About Alt+H+A Displays the About dialog box with version information 
InstallShield for AdminStudio. 
AdminStudio 
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Menu Command Shortcut Button Description 

Context Run Task al Runs the tool associated with the selected task in the 
Menu project. 

Context Move Up t Moves the selected task up in the task order. 
Menu 

Context Move Down + Moves the selected task down in the task order. 
Menu 

Context Move Left + Moves the selected task left in the task order. 
Menu 

Context Move Right > Moves the selected task right in the task order. 
Menu 


Start Tab 


The Start tab is displayed when the AdminStudio Interface is launched. It consists of two main areas: 


m the Tools Gallery, and 
E the Content Pane 


t% testlabsql2k (HoweCatalog2004) - sa - InstallShield AdminStudio 


| Catalog View Tools Help 


|o a |m|~+ 


© 3 


QuickStart Guide Repackager 


DevStudio 


| 


QualityMonitor 


Py > 


Tuner 


ConflictSolver 


a 


Distribution Wizard Global Exclusions 


Editor 
Hy & 
OS Snapshot 


Application Isolation 
Wizard Wizard 


@® start |G) Projects Workflows 
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AdminStudio 


InstallShie 


QuickStart Guide 


Welcome to InstallShield AdminStudio, the most easy-to-use and reliable solution for 
repackaging legacy setups, customizing Windows Installer packages, and resolving 
application conflicts. Click on a question in the graphic below to discover the 
AdminStudio solution, or click in the center of the image for an overview of the 
Application Migration process. 


Do you have a legacy 
setup you need to convert 
into a Windows Installer 

package (MSI)? 


w 
X ana |i 


QuickStart 


Do you want to author 
or enhance a Windows 
Installer package or 
repackaged setup? 


Do you want to customize 
a Windows Installer 
package without altering 


— 
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By right-clicking in the gallery, you can launch the Add Tool Wizard, from which you can add new tools into the 
gallery and make them available for task assignments in workflows and projects. 


You can also launch each tool in the AdminStudio suite by double-clicking on the appropriate icon. If you single-click 
on an AdminStudio tool icon, information about that tool is displayed in the content pane. 


The first icon in the gallery, QuickStart Guide, is selected by default. When selected, this icon displays the 
AdminStudio Start page, containing an interactive graphic that is the front-end to a conceptual overview of 
AdminStudio. 


Workflows Tab 


Workflows, which can be created and modified from the Workflows tab, are the basis for all projects in AdminStudio. 


t? Production.mdb - InstallShield AdminStudio 
| Catalog View Tools Help 
joa |ml/*|t|+++-+ oe! 


All Workflows v 1. Package Evaluation 
a | Workflow Properties 


1. Package Evaluation 

2. Repackage a Legacy Application 

3. Tune an MSI Package 

4. Identify Conflicts in an MSI Package 


eh) 


AdminStudio 


Task Help Page 


Provide information and/or instructions involving this task, and 
replace this default page with your new HTML page. 


Objective: 
< 


® Start | Projects Workflows 


These workflows consist of defined tasks, with which instructions (in the form of HTML files) and tools can be 
associated. Users can then create projects based on these workflows, and execute them—following the specific steps 
defined in the workflow. This allows you to create specific, repeatable procedures to accomplish your application 
migration goals. 
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Tasks 


Once you create a workflow, you can add tasks to it. Tasks are discrete steps in your overall process. Each task has the 
following configurable options: 


v Specify Product Information 


Task Properties 


Tool 


Tool Configuration 


<None> 


v | Properties... 


<None> 


~| (Configure... 


Help File Browse... {al 
Notes 
Option Description 
Tool If needed, you can pick a tool to associate with the task. When a user runs the workflow, the tool 


can be launched from the workflow step. By default, the AdminStudio tools are included in this list. 
If you have added tools to the Tools Gallery, they also appear in this list. If you want to add a tool 
directly from the Workflows tab, select the <New Tool> option to display the Add New Tool dialog. 
This adds the tool to the Tools Gallery and makes it available for the current task. 


Note: If, after adding a new tool for a task that is not included in the Tools Gallery, you assign a different tool 
or no tool to the task, the tool you added will no longer be available. To avoid this, when possible, 
add tools to the Tools Gallery 


Tool Configuration 


This list contains all available command-line configurations for the selected tool. If you do not need 
a configuration, select <None>. Click Configure to add new configurations to the tool, which you 
can then select from this list. 


Help File You can associate a help file (in HTML format) with the task to provide instructions for performing 
the task. Enter the path and help file in this field, or use the Browse button to navigate to it. If you 
have yet to create an HTML page, click the Edit HTML button to the right of the Browse button to 
open a default page in an HTML editor. 

Notes Add any notes you want associated with this task. This field can only hold 255 characters, so 


additional information should be added to your help file. 
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Projects Tab 


From the Projects tab, you can create, execute, and delete projects. You can also access existing projects. The drop- 
down filter above the Project pane allows you to view all available projects, or only a specific project. 


tè Production.mdb - InstallShield AdminStudio 


| Catalog View Tools Help 


JO a|mla\t|+r+ + |e! 
All Projects - 1. Package Evaluation 


- Project Properties 
o 1. Package Evaluation 2 j 
E 2. Repackage a Legacy Application Source Package 
H-0) 3. Tune an MSI Package 


Target Directory C:\AdminStudio Shared\, 


Target FileName output 


Notes 


AdminStudio 


Projects 


4 project consists of tasks required to complete a procedure. When you 
create a project, you base it off of an existing workflow template. Each 
task appears with a check box that you can click when the task has been 

il | > 


Each project must be based on an existing workflow. In this way, projects are similar to photocopies from a master 
instruction sheet—all planning and design of the procedure is done to the workflow. The project is a copy of that 
workflow, and multiple projects can be based on the same workflow if you are performing the same procedure. 


InstallShield Software Corporation © 2004 101 


AdminStudio 5.5 User Guide 3 Using the AdminStudio Interface 


Integration with AMS 


InstallShield AMS 2.0 is a Web-based application that manages the application lifecycle, incorporating standards (data) 
and methodologies (process). AdminStudio Workflows and AMS Workflows can be integrated, so that an 
AdminStudio Project can be a Workflow Phase in an AMS Workflow. 


O 


Workflow Integration with AMS is a snap-in feature available only with InstallShield AMS 2.0. 


When an AdminStudio Project is linked to an AMS Workflow, please note the following indications on the 
Projects tab: 


m When an integrated AdminStudio project is selected on the Projects tab, the name of its associated AMS 
Application is displayed in the Project Properties. 


mE When an AdminStudio Project is linked to an AMS Workflow and the workstation is not currently connected to 
the AMS Server, the following icon appears in the bottom right of the Projects tab view: 


FJ 
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The following dialog boxes can be accessed from the AdminStudio Interface. 


About InstallShield AdminStudio Dialog 


The About InstallShield AdminStudio dialog can be accessed by selecting About AdminStudio from the Help menu. 
This dialog displays information about the product, including the full version number (essential if you need technical 
support). If you have not registered AdminStudio, click the Register button to connect to the InstallShield Web site to 
begin the Product Registration process. Registering your product offers you expert technical support, new product 
announcements and special offers, plus notification of product upgrades. 


Add New Tool Dialog 


The Add New Tool dialog is displayed if you select <New Tool> from the Tool list while designing a workflow. This 
dialog allows you to provide information about a tool you want accessible from AdminStudio, particularly to use in 
workflow tasks. 


Add New Tool 


| Properties 


Target: 


Name in Tools Gallery: Browse... 


Command Line Arguments: 


Working Directory: 


Comments: 


| HTML Explanation File: 


| [M] Add to Tools Gallery l 
Cancel Help l 
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This dialog contains the following fields: 


Field 


Description 


Target 


Enter the location of the tool or Browse to the application or file you want added to the tools 
pane for use in AdminStudio. 


Name in Tools Gallery 


This description is used as the display name for the application in the Tools Gallery. 


Command Line 
Arguments 


Enter any command-line arguments for the tool. Because you may have different uses for 
applications, you can add the same application multiple times to the tools pane, with each 
instance using different command line arguments. 


Working Directory 


If this fool requires a working directory, enter it here or click Browse to locate it. 


Comments 


Enter any comments about this tool in this field. 


HTML Explanation File 


Enter the location and name of an HTML file you want displayed when you single-click on the 
tool in the tools pane. Alternatively, click Browse and navigate to it. If you have yet to create 
one, click the Edit HTML button below the field to open a default page in an HTML editor: 


[al 


Add to Tools Gallery 
Check Box 


When this box is checked, the tool will be added to the Tools Gallery. If unchecked, it is only 
available for the task where it was added. 
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Add User Dialog 


This is a snap-in feature available only with InstallShield AMS 2.0. 


The Add User dialog, displayed when you click Add NT User in the Manage Users Dialog, allows you to add an NT 
user or group for Application Catalog access. 


Add User 


Domain: 


INSTALLSHIELD v 


Users and groups: 


Name Comment Ke] 
Accounting Account Department a 
Accounting Manage Global Group For Accounting M... 
AccountsUK 

AdminStudio 

Cert Publishers Enterprise certification and re... 
Consulting IS Consulting Department 
ConsultingInst-1 

ConsultingInstallShi 


Members... 


Possible users and groups are determined by the Domain list; only trusted domains and local domains are displayed in 
the Domain list. 


Select a user or group to add, and click OK. You can also see who is in an NT group by selecting the group and 
clicking Members to view the Group Members Dialog. 
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Change Password Dialog 


The Change Password dialog is displayed if you select Change Password from the AdminStudio Interface Catalog 
menu. This dialog allows the current logged-in user to change their SQL Server login password from within 
AdminStudio. 


Change Password 


User Name: sa 


SOL Server: testlabsql2k 


Old Password: 


New Password: 


Confirm New Password: 


In InstallShield AMS 2.0, SQL Server Administrators (users who are members of the sysadmin role) can change the 
password of any SQL user using the Manage Users dialog, which is displayed when you select Security from the 
Catalog menu. If you are only an AdminStudio Administrator, you may not be able to change the password of other 
SQL users. By default, AdminStudio Administrators belong to the following SQL Server roles: securityAdmin, dbcreators, 
and db_owners. See Manage Users Dialog for more information. 


The Change Password menu item is disabled for Access databases and non-SQL Server logins. 


The dialog consists of the following fields: 


Field Description 

User Name Your User Name automatically populates this field and cannot be edited. 

SQL Server The SQL Server that you are logged into automatically populates this field and cannot be edited. 
Old Password Enter your current password. 


Note: If you accessed this dialog via the Manage Users dialog, this field is disabled. 


New Password Enter a new password. 


Confirm New Enter the new password exactly as it appears in the New Password text box. 
Password 
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Command Line Properties Dialog 
The Command Line Properties dialog is displayed when you create or edit a command-line configuration for a tool. 


Command Line Properties 


Description: | Create a new transform for a Windows Installer package (.msi) 


Command Line: | "[SourcePackage]";"[TargetDir]\[TargetFileName].mst"| 


The Command Line Properties dialog has two configurable fields: 


Field Description 

Description Provide a description for the configuration. This assists you in differentiating similar command- 
line options. 

Command Line Provide the actual command-line parameters for the tool. The arrow to the left allows you to 


select one of the following variables to include in the command-line: 


= = InstallLocation—The location where AdminStudio is installed. 

a DevLocation—The location where InstallShield DevStudio is installed. 

= SharedPoint—The AdminStudio shared directory. 

=» SourcePackage—The name and location of the source package. 

= TargetDir—The directory where output from the selected project is stored. 
= TargetFileName—The name of the output file. 

= ProjectName—The name of the current project. 


Create / Connect to Application Catalog Dialog 


The Create / Connect to Application Catalog dialog appears when you either create a new or open an existing 
Application Catalog. If you are creating a new Application Catalog, only the New tab appears. 


Create Application Catalog 


= © Microsoft Access 
| 


O Microsoft SOL Server / MSDE 
= 


AdminStudio Application Catalog is required to store Projects 
and Workflows, and to store tools associated with individual 


tasks. Specify the type, name, and location of a new 
AdminStudio Application Catalog and click Create. 


[C] Make this the default shared Application Catalog 
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If you are opening an existing Application Catalog, the Existing and Recent tabs are displayed. 
Connect to Application Catalog 


Existing (Recent) 


= © Microsoft Access 
[ 


O Microsoft SOL Server / MSDE 
= 


If you want to connect to an existing AdminStudio Application 
Catalog, specify it here and click Open. 


Both the New and Existing tabs have the same basic functionality. You can select whether you want to create/open a 
Microsoft Access-based Application Catalog or a Microsoft SQL Server/MSDE-based Application Catalog. If you 
select the Microsoft Access-based Application Catalog option, provide a name and location for it. If you select the 
Microsoft SQL Server/MSDE-based Application Catalog option, the SQL Server / MSDE Login dialog is displayed 
when you click Create or Open. 


The Recent tab provides a list of recently accessed Application Catalogs. When you select one and click Open, either 
the Application Catalog opens or you are prompted for SQL Server login information (if you need authentication to 
the Application Catalog). 


Connect to Application Catalog 


| Existing) Recent | 

“Catalogs 

 AdminStudio Application Sample Catalog... 
 C:\AdminStudio Shared\Production.mdb 


testlabsql2k (HoweCatalog2004) - sa 
C:\AdminStudio Shared\HoweT echnology.mdb 


[C] Make this the default shared Application Catalog 


At the bottom of the dialog is the option Make this the default shared Application Catalog. When this option is 
selected, the Application Catalog you are trying to open or create will become the default Application Catalog (and be 
recorded as such in the AdminStudio shared directory). If the Application Catalog is made the default, all other 
AdminStudio users that use the same shared directory will automatically connect to the default Application Catalog 
when AdminStudio is launched. Therefore, you should only set this option if you want to affect all AdminStudio users 
who access that shared directory. 
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© 


For InstallShield AMS 2.0, only the AdminStudio Administrator or users with the Change Default Database permission 
will see the Make this the default shared Application Catalog option. This allows the AdminStudio Administrator to 
configure the default Application Catalog, and then subsequent installations of AdminStudio will automatically connect 
to the default Application Catalog if they use the same shared directory. 


Group Members Dialog 


@ 


This is a snap-in feature available only with InstallShield AMS 2.0. 


The Group Members dialog is displayed when you select a group from the Add User Dialog and click the Members 
button. 


Group Members 


Members of 'INSTALLSHIELD\AccountsUk' Group: 
| Name 


DenahStevens 
AndrewStubbs 
JennyRideout 
StuartHarris 


From this dialog, you can see all members of the selected NT group. Click OK to dismiss the dialog. 
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This is a snap-in feature available only with InstallShield AMS 2.0. 


The Manage Roles dialog, available when you click Manage Roles from the Manage Users dialog, allows you to create 
new roles, delete existing roles, view to whom roles are assigned, and set permissions for roles. 


Manage Roles 


Roles: 
Role 
R Administrator 


T 


Permissions For ‘Author’: 


Permissions Type 
Edit Workflow Properties Workflow 
Delete Workflow Workflow 
Create Workflow Workflow 
View Workflow Tab Workflow 
Edit Project Properties Workflow 
Delete Project Workflow 
Create Project Workflow 
Launch Tool Workflow 
Edit Tool Properties Workflow 
Delete Tool Workflow x 


Ce 


K K K K NK KK 


The dialog includes the following controls and functionality: 


Control Description 

Roles list Provides a listing of all roles in the Application Catalog. 

Permissions list Provides a list of available permissions for the selected role. 

New Launches the New Role dialog and allows you to create a new role based on an existing role. 

Delete Removes the selected role from the Application Catalog. Any user assigned the deleted role will no 
longer have the permissions associated with the role. 

Members Displays the Role Members dialog, which shows the users to whom the role has been assigned. 
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This is a snap-in feature available only with InstallShield AMS 2.0. 


The Manage Users dialog is displayed when you select Security from the Catalog menu. It allows you to add or 
remove user access to the AdminStudio Application Catalog, change a user's SQL Server password, and assign roles 
to users. Each role has associated permissions, so the role assigned to a user defines the tasks the user can perform in 
AdminStudio. 


Manage Users 


Users: 


Name LoginName Role 
b ASAdmin ASAdmin Administrator 


ES do sā Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions for ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 


The dialog consists of the folowing controls and functionality: 


Control Description 


Users list Allows you to see the list of users (and NT groups) that have access to the AdminStudio Application 
Catalog. Each user type is indicated by a different icon: 


& Windows NT User 
82 Windows NT Group 


& SQL Server User 


To change a user's SQL Server login password from within AdminStudio, right click on a user name 
and select Change Password from the menu. The Change Password Dialog appears. 
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Control Description 

Roles list Allows you to associate a role with a user. 

Permissions list Allows you to view the permissions associated with the currently selected user and role. 
Add NT User Displays the Add User dialog, allowing you to add an NT user or group for access to the 


AdminStudio Application Catalog. This is the recommended way to add users. 


New SQL User Displays the New User dialog, allowing you to create a new login and password using SQL Server 
security. This is essentially the same as adding a new user to a database using the SQL Server 
Enterprise Manager. 


Remove Allows you to revoke AdminStudio access for the selected user. 


Manage Roles Displays the Manage Roles dialog, allowing you to define new roles, remove existing roles, or 
associate permissions with roles. 


New Role Dialog 


IE > 
| — 
W bi, 
This is a snap-in feature available only with InstallShield AMS 2.0. 


The New Role dialog is displayed when you click New on the Manage Roles Dialog. 


New Role 


Role name: 


Based on: 


Administrator v | 


On this dialog, you can provide a Role name for the new role and starting permissions Based on an existing role. After 
you define a new role, you can modify permissions for that role in the Manage Roles dialog. 
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New User Dialog 


This is a snap-in feature available only with InstallShield AMS 2.0. 


The New User dialog is displayed when you click New SQL User on the Manage Users Dialog. 


SOL Server login: 


Password: 


This dialog allows you to add a new user to the currently open SQL Server—based Application Catalog. Provide the 
SQL server login name and Password for the new user, and click OK. When you return to the Manage Users dialog, 
the user appears in the Users list. You can then configure the user's role and permissions. 


Options Dialog 


From the Options dialog, you can configure settings including shared locations and the frequency AdminStudio 
checks for updates. The dialog consists of the following tabs: 


Locations Tab 


Options 


| Locations | InstallShield Updates 


Shared AdminStudio Application Catalog: 
:AdminStudio Shared\Production. mdb 


AdminStudio Shared Location: 
|C:\AdminStudio Shared’, Browse... 


Task Help Page Location: 


C:\AdminStudio Shared\Help Browse... 


Application Management S ystem [AMS] Web site URL: 
http://172.17.1.142 


[ox] ee (rob) 
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From this tab, you can configure the following options pertaining to workflows: 


Option Description 
Shared AdminStudio This field displays the name and location of the shared AdminStudio Application 
Application Catalog Catalog. Click the Browse button to connect to another Application Catalog using 


the Connect to Application Catalog Dialog. 


AdminStudio Shared Location Enter or browse to the shared location for AdminStudio. This location will contain 
shared information for repackaging and conflict identification. To maintain 
consistency when creating workflows, InstallShield recommends that you set this 
shared location the same for each AdminStudio seat. 

Note: The AdminStudio Shared Location is defined during installation and normally does not 


need to be changed. It is usually assigned to a network folder, preferably a UNC 
path. 


Task Help Page Location Enter or browse to the directory where you want to store all HTML pages that serve 
as workflow task instructions. 


Application Management Enter the URL for the AMS Web site. (InstallShield AMS 2.0-only) 
System (AMS) Web Site URL 


InstallShield Updates Tab 


Options 


Locations | InstallShield Updates 
InstallShield AdminStudio Software Updates 
7 Use the InstallShield Update Service to ensure that 
InstallShield ådminStudio is up to date. 


Check for software updates 


Once every 30 days 
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You can configure the following options from this tab: 


Option Description 
Check for content From this list, select when to check for content updates. You can either select to check when 
updates AdminStudio is launched (default), or to never check for updates. 
Check for software Specify how often you want to check for updates to AdminStudio. Your options are: 
updates = Never 

= Once every 15 days 

= Once every 30 days (default) 

= Once every 60 days 


Role Members Dialog 


This is a snap-in feature available only with InstallShield AMS 2.0. 


The Role Members dialog is displayed when you click the Members button on the Manage Roles Dialog. 


Role Members 


Members: 


Name 
ĝ asadmin 
B sa 


It provides a listing of all members assigned to the currently selected role. Click OK to dismiss the dialog. 
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SQL Server / MSDE Login Dialog 


The SQL Server / MSDE Login Dialog is displayed when you create a new SQL Server-based Application Catalog in 
the AdminStudio Interface, or when you attempt to open a SQL Server-based Application Catalog in either the 
AdminStudio Interface or ConflictSolver. 


SQL Server / MSDE Login 


Server: | TESTLABSQL2K 


How should SOL Server verify the authenticity of the login ID? 
Ov With Windows NT authentication using the network login ID, 


@ With SQL Server authentication using a login ID and password 
entered by the user, 


Login ID: [sa O 


Password: f o 


Database: | A531WorkFlow 


This dialog includes the following controls: 


Control Description 


Server The list of available SQL Servers on the network. You can also manually enter the name of the SQL 
Server to which you want to connect. 


Authentication Select one of the following options: 


a With Windows NT authentication using the network login ID—Choose to use Windows 
network authentication. 

= With SQL Server authentication using a login ID and password entered by the 
user—Choose to use SQL Server login identification for authentication. If you use SQL Server, 
enter the Login ID and Password. 


Database Select the database from those available on the SQL Server. 


Create database Select this checkbox to designate this new Application Catalog as a Subscriber database in 

as a subscriber Application Catalog Replication (a database that receives replicated data). When this option is not 
selected, or when an existing database is upgraded, the Application Catalog is defined as a Publisher 
database in Application Catalog Replication (a database that makes data available for replication). 


The AdminStudio interface selectively enables/disables the Replication menu items on the Catalog 
menu based upon the type of Application Catalog that is currently opened. 


Note: Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. If you have 
AdminStudio Standard or Professional Editions, this checkbox is disabled. 


Note: This checkbox only appears when creating a new SQL Server / MSDE database, not when logging in to an 
existing database. 


Test Click this button to test whether a connection can be made to the database. 
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Tool Properties Dialog 


The Tool Properties dialog is displayed when you right-click on a tool in the Tools gallery and select Properties. This 
dialog contains the Properties and Configuration tabs. 


Properties Tab 


The Properties tab contains information about the tool, including the name and location of the executable, the name 
of the tool as it appears in the Tools gallery, and the help file associated with it (if any). 


Tool Properties 


= u 
Properties | Configuration | 


5 ConflictS olver 


Target: 
tam Files\InstallShield\AdminStudio\5. 5\ConflictS olver\ISCMIDE exe | 


Name in Tools Gallery: Browse... 


ConflictS olver 


Command Line Arguments: 


Working Directory: 


Comments: 


HTML Explanation File: 
C:\Program Files‘InstallS hield\AdminS tudio‘ 5. 5\Program\0409\Contli 


Pe 


The following properties can be configured: 


Property Description 

Target Enter the location of this tool's executable. Alternatively, click Browse and navigate to it. 
Name in Tools Gallery Provide a name for the tool as it will appear in the Tools gallery. 

Command Line Enter any default command line arguments for this tool. 

Arguments 

Working Directory If this tool requires a working directory, enter it here or click Browse to locate it. 
Comments Provide any comments about this tool. 
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Property Description 


HTML Explanation File Enter the location and name of an HTML file you want displayed when you single-click on the 
tool in the tools pane. Alternatively, click Browse and navigate to it. If you have yet to create 
one, click the Edit HTML button below the field to open a default page in an HTML editor: 


[Lal 


Configuration Tab 


From the Configuration tab, you can Add, Modify, or Delete command-line configurations associated with the tool. 
Each tool can have multiple configurations associated with it, for different uses. 


Tool Properties 


| Properties | Configuration | 


Each tool can have one or more command-line configurations associated 
| with it. These configurations can be used as required for specific tasks. In 
| addition to entering the command line, you can provide a description to 
| identify the configuration's purpose. 


Description Command Line 
Create a new tra... "[SourcePackage]"""[T argetDir]\[T argetFileN ame]. 
Edit a transform "(SourcePackage]'';"[T argetDir]\[T argetFileN ame]. 


Ll > 


en ST TT 
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Property 


Description 


Command Line List 


Listing of all command lines defined for this tool. 


Add 


Click to access the Command Line Properties Dialog, where you can add a new command line. In 
the Description field, you provide a description for the configuration. This assists you in 
differentiating similar command-line options. In the Command Line field, you provide the actual 
command-line parameters for the tool. The arrow to the left allows you to select one of the 
following variables to include in the commandline: 


Installlocation—The location where AdminStudio is installed. 
DevLocation — The location where InstallShield DevStudio is installed. 
SharedPoint—The AdminStudio shared directory. 

SourcePackage—The name and location of the source package. 
TargetDir—The directory where output from the selected project is stored. 
TargetFileName—The name of the output file. 


ProjectName—The name of the current project. 


Click to access the Command Line Properties Dialog, where you can modify the selected command 
line. 


Click to delete the selected command line. 


Most AdminStudio Tools have one or more command-line configurations already defined. Although you can change or 
remove these configurations, there is no way to automatically reset them to their default values. 


Ways to Assign a Command Line to a Tool 


There are three ways a user can assign a command line to a tool: 


m Tool Properties Panel of Add Tool Wizard—When you add a tool, you can assign a command line on the 
Tool Properties Panel of the Add Tool Wizard. 


= Properties Tab of the Tool Properties Dialog—When you view the tool's properties, you can assign a 
command line on the Properties Tab of the Tool Properties Dialog. 


E Configuration Tab of the Tool Properties Dialog— Using the Configuration Tab of the Tool Properties 
Dialog, you can create multiple command lines and can use AdminStudio variables in these command lines. Then, 
when you go to the Workflow tab and create a new Workflow, you can associate a Tool with a task and also select 
which command line configuration they want to use. Once you have done that, you can go to Project tab and 
create a new Project. When you create a new Project, you will have to specify the Source Package and the target 
directory and file name. Once the Project is created, when you execute the task, AdminStudio will execute the 
command line configuration you previously selected by replacing the AdminStudio variables in the command line. 
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A command Line entered by the user in Properties Tab of the Tool Properties Dialog play no role in the Workflow and 
Project tab. This command line is used only when you run the fool from the Tools Tab. 


The User Properties dialog, available from the Catalog menu in both the AdminStudio Interface and ConflictSolver, 
allows any user to view their current roles and permissions in AdminStudio. Because users may be members of 
multiple NT groups—each with associated roles and permissions—any role associated with the user is displayed in the 
Roles list. A cumulative list of permissions is displayed in the Permissions list. 


User Properties 
8 User name: sa 
Server: testlabsqlZk 
Database: HoweCatalog2004 
Database Type: Publisher Database 


Roles: Permissions: 
| Administrator Full Control 


The Database Type entry in this dialog identifies any SQL Server database as being either a Subscriber or Publisher. 
See Application Catalog Replication. 
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Wizards 


Add Tool Wizard 


The Add Tool Wizard allows you to add new tools that appear in the AdminStudio Tools gallery. You can specify the 
tool's executable, provide command-line options for the tool, and provide a link to information about the tool. 


The Add Tool Wizard includes the following panels: 


m Welcome Panel 
m Tool Properties Panel 
Em Tool Command-Line Options Panel 


Welcome Panel 


The Add Tool Wizard allows you to add new tools that appear in the AdminStudio Tools gallery. You can specify the 
tool's executable, provide command-line options for the tool, and provide a link to information about the tool. 


Add Tool Wizard 


Welcome to the Add Tool Wizard. 


Using the Add New tool Wizard, you can add and 
configure tools in the AdminStudio Tools gallery. You can 
specify the executable to launch, enter command-line 
arguments for the tool, and provide an HTML file 
explaining how and when to use the tool. 


Click Next to proceed to the Tool Properties Panel. 
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Tool Properties Panel 


From the Tool Properties panel, you can enter information about the tool you are adding to the gallery. 


Add Tool Wizard 


Tool Properties 
Configure properties for the tool. F 


Target: 
| | 


Name in Tools Gallery: 


Command Line Arguments: 
ji 


Working Directory: 


Browse... 


Comments: 


HTML Explanation File: 


| Co Lal 


You can configure the following properties: 


Property Description 

Target Enter the location and name of this tool's executable. Alternately, click Browse and navigate 
to it. 

Name in Tools Gallery Provide a name for the tool as it will appear in the Tools Gallery. 

Command Line Enter any default command line arguments for this tool. 

Arguments 

Working Directory If this tool requires a working directory, enter it here or click Browse to locate it.. 

Comments Provide any comments about this tool. 

HTML Explanation File Enter the location and name of an HTML file you want displayed when you single-click on 
the tool in the tools pane. Alternatively, click Browse and navigate to it. If you have yet to 
create one, click the Edit HTML button below the field to open a default page in an HTML 
editor: 


Click Next to proceed to the Command-Line Configurations Panel; click Back to return to the Welcome Panel. 
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Command-Line Configurations Panel 


From this panel, you can add command-line configurations for the tool. Each tool can have multiple command-line 
configurations for different tool uses. 


Add Tool Wizard 


Command-Line Configurations 
Provide Configurations for the specified tool. 


Each tool can have one or more command-line configurations associated with it. These 
configurations can be used as required for specific tasks. In addition to entering the command 
line, you can provide a description to identify the configuration's purpose. 


Command Line 


Click Add to add a new option from the Command-Line Properties Dialog. You can also click Modify to edit the 
selected command-line option, or Delete to remove the selected option. Click Finish to add the tool to the Tools 
Gallery; click Back to return to the Tool Properties Panel. 


New Workflow Project Wizard 


The New Workflow Project Wizard assists you in creating a new project based on an existing workflow. The values 
you specify in this Wizard are stored in variables that can be accessed from tools, allowing for greater interoperability 
in AdminStudio. The New Workflow Project Wizard includes the following panels: 


Welcome Panel 

Workflow Selection Panel 

Source Package Panel 

Target Directory and File Name Panel 
Project Assignment Panel 
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Welcome Panel 


The New Workflow Project Wizard assists you in creating a new project based on an existing workflow. The values 
you specify in this Wizard are stored in variables that can be accessed from tools, allowing for greater interoperability 
in AdminStudio. 


New Workflow Project Wizard 


Welcome to the New Workflow Project Wizard. 


This wizard creates a new project based on an existing 
workflow. Multiple projects can be based on a workflow, 
and each project begins as a copy of that workflow. 


Click Next to proceed to the Workflow Selection Panel. 


Workflow Selection Panel 


Prom the Workflow Selection panel, you can specify the workflow on which you want to base this project. Available 
workflows appear in the workflows window. 


New Workflow Project Wizard 


Workflow Selection 
Select the workflow on which you want to base your project. 


Em) 2.Repackage 3. Conflict 
SEVE aLegacy À... Analysis 


Provide a name for the new project: 


1. Package Evaluation 


ETE ETE | ETE 


Select the workflow you want to use, and provide the name for the new project (which is stored in the ProjectName 
predefined variable). 
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Click Next to proceed to the Source Package Panel; click Back to return to the Welcome Panel. 


Source Package Panel 


From the Source Package panel, you can specify the name and location of the source package used in this workflow. 
If you are creating a repackaging project, this is usually an executable, such as Setup.exe. The source package name 
and location is stored in the predefined variable SourcePackage. 


New Workflow Project Wizard 


Source Package 
Provide the name and location of the source package. 


Specify the name and location of the source package used in this project (if required): 


L 


represents the source file for the workflow. The SourcePackage variable can be used 
when creating tool configurations in AdminStudio. 


i The source package and directory are stored in the SourcePackage variable, and 


For repackaging workflows, the source package is typically a Setup.exe file. Other 
workflows may require a Windows Installer package [.msi] as a starting point. 


Altermatively, a simple workflow that involves editing text in a Notepad file may use a .txt 
file for the source package. 


[cise Jones) (tant) (he) 


You must specify the name and location of a source package if it is required in the workflow (by using the 
SourcePackage variable). For example, if the workflow specifies to launch a package with certain command-line 
parameters, AdminStudio needs to know what package to launch. 


Source packages can also be non-setup files. For example, if you are creating a simple workflow that involves editing a 
Notepad file, the source package may be a .txt file. 


Click Next to proceed to the Target Directory and File Name Panel; click Back to return to the Workflow Selection 
Panel. 
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Target Directory and File Name Panel 


From the Target Directory and File Name panel, specify the Target Directory and Target File Name used in this 
project. 


New Workflow Project Wizard 


Target Directory and Filename 
Specify the output directory and filename. 


Specify the directory in which you want to store all files associated with this project. If multiple 
users will work on this project, consider using a network location. 


Target Directory: 
C:‘AdminStudio Shared v | 


Specify the name you want to use for project task output. Depending on the task you are 
performing, the appropriate file extension is added to this value. For example, if you are 
repackaging an application, the Repackager project will be named MySetup.irp. 


Target File Name: 


e 
l ) If a target directory or target file name is required, you must enter it before proceeding. 


Cr Jone) Cere) Cl 


All output files (such as an INC file from Repackager or an MST file from Tuner) associated with the project will be 
stored in the Target Directory, and the value for this directory can include a predefined variable such as SharedPoint. 
The Target File Name is the name used for all files created by project tasks in this project, with the appropriate 
extension appended to it depending on the file type. The Target Directory is stored in the predefined variable 
TargetDir and the output file name is stored in the variable TargetFileName. 


If any workflow tasks use the TargetDir or TargetFileName variables, you must specify the target directory and package 
name. For example, if the workflow specifies to save a task's output, AdminStudio needs to know where to save it and 
what to call it. 


If you are the AdminStudio administrator and are using InstallShield AMS 2.0, you can click Next to proceed to the 
Project Assignment Panel. If you are not the administrator, or are using AdminStudio Standard or Professional 
Edition, click Finish to dismiss the Wizard. You can also click Back to return to the Source Package Panel. 
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Project Assignment Panel 


@ 


This is a snap-in feature available only with InstallShield AMS 2.0. 


Prom the Project Assignment panel, specify the user to whom the project is assigned. The list of available users is 
drawn from those in the AdminStudio Application Catalog. 


New Workflow Project Wizard 


Project Assignment 
Assign the project to user. 


Select the user who will be responsible for this project. The project will appear under the user's 
name in the Projects tab. 


AdminStudio Application Catalog Users: 


Name Login Name 
& ASAdmin ASAdmin 
dbo sa 


(cise) fre) (tones) (te) 


Click Finish to add the new workflow using the values specified in the previous panels; click Back to return to the 
Target Directory and File Name Panel. 


Upgrade Wizard 


When you attempt to open an AdminStudio 3.0, 3.01, or 3.5 Workflow or ConflictSolver database, AdminStudio 5 
prompts you to upgrade the existing database to an AdminStudio 5 Application Catalog. The source Workflow or 
ConflictSolver databases can be Microsoft Access or SQL Server, and the destination Application Catalog can be 
either Access or SQL Server. 


Log files for the upgrade are created in the <SharedLocation>\ConflictSolver\Logs directory. Access databases are 
backed up in the same directory as the upgraded Application Catalog. SQL Server databases do not drop old tables 
from the Application Catalog. 


The Upgrade Wizard consists of the following panels: 


Welcome Panel 

Source Databases Panel 

Target Application Catalog Panel 
Upgrade Progress Panel 
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Welcome Panel 


This is the initial panel displayed when the Upgrade Wizard is launched. 


Upgrade Wizard 


Welcome to the AdminStudio Upgrade 
Wizard 


| A > e] This wizard is designed to transfer your existing 
AdminStudio 5.0, 3.5, 3.01 and 3.0 Workflow and 
ConflictSolver databases into the AdminStudio 5.5 
Application Catalog. 


Click Next to continue. 


Click Next to proceed to the Source Databases Panel. 


The Source Databases panel allows you to provide the names and locations of the Workflow and ConflictSolver 
databases to upgrade to an Application Catalog. By default, the Upgrade Wizard identifies the default Workflow and 
ConflictSolver databases stored in the Windows Registry. 


Upgrade Wizard 


Source Databases 
Select the legacy AdminStudio database(s] to update. 


Specify the AdminStudio 5.0, 3.5, 3.01 or 3.0 Workflow and ConflictSolver databases to merge 
into the AdminStudio 5.5 Application Catalog. 


Workflow: 
C:\AdminStudio Shared‘S ample orkflow.mdb 


ConflictS olver: 
C:\AdminStudio Shared\ConflictS olverOLD.mdb 


Change 


If these are not the databases you want to upgrade, click the Change button for the appropriate database to display the 
Connect to Application Catalog Dialog, from which you can browse to the appropriate database (and login for SQL 
Server databases). 
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Click Next to proceed to the Target Application Catalog Panel; click Back to return to the Welcome Panel. 


Target Application Catalog Panel 


The Target Application Catalog panel allows you to create or select the destination Application Catalog that will store 
data from the previously selected Workflow and ConflictSolver databases. You can specify the new Application 
Catalog to be a Microsoft Access or SQL Server Application Catalog, or use an existing Application Catalog. 


Upgrade Wizard 
Target Application Catalog 
Specify the Application Catalog name and location. [m0] 
Choose the target Application Catalog to hold the current Workflow and ConflictSolver 


database. 


Application Catalog: 
C:\AdminStudio Shared\ConflictS olverOLD.mdb | 


Upgrade Options: 
Import Merge Modules 


If you need to change the suggested Application Catalog, click Change to display the Connect to Application Catalog 
Dialog. 


Additionally, you can import merge modules from the <CommonFilesFolder>\Merge Modules folder into 
ConflictSolver. If you select this option, your upgrade can take a considerable amount of time, depending on the 
number of merge modules available. However, this time consideration is outweighed by the result that a large amount 
of merge modules will already be in the ConflictSolver when you are ready to perform conflict identification and 
resolution. 


If you are using ConflictSolver extended attributes, you can also specify the extended attribute description file (.xml). 


Click Upgrade to begin the upgrade; click Back to return to the Source Databases Panel. During upgrade, the Upgrade 
Progress Panel appears. 
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The final panel in the Upgrade Wizard is the Upgrade Progress panel, which displays the results of the upgrade. 
Upgrade Wizard 
Upgrade Progress 


Upgrading selected database{s]. 


This panel displays the progress information for the upgrade process 


Upgrading to Target Application Catalog 'C:\AdminStudio Shared\ConflictSolve A 
Upgrading existing schema of Target Application Catalog 'C:\AdminStudio Shared\ConflictSoly — 


Upgrading from Source Database 'C:\AdminStudio Shared\ConflictS olverOLD.r 
Enumerating groups and products from the old schema 

Upgrading packages 

Upgrading packages: 1 of 2 

Importing 'M:‘AdminStudio'\ConflictS olver\D ata\CorelDrawMS1\CorelDraw.msi' 


Click Finish to exit the Upgrade Wizard. 
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Methods of Sharing Application Catalog 
Data 


ConflictSolver provides three options for sharing Application Catalog Data: 


= Merging Application Catalog Information—Usce the Merge Wizard to merge the source Application 
Catalog's data into the currently open Application Catalog. The merged data is not linked in any way to the source 
Application Catalog. 


E Linking to Application Catalog Information—Use the Remote Package Alert Wizard to link to individual 
packages in remote Application Catalogs, and import these packages into your local Application Catalog. To 
update the contents of your local Application Catalog with the data on the remote Application Catalogs that you 
are linked to, you can choose to Refresh package data. 


= Replicating Application Catalogs—Use Application Catalog Replication's Publication and Subscription 
Wizards to distribute an Application Catalog database where it is needed across a large enterprise or multi-national 
corporation. Data is replicated between a Publisher Database Server and a Subscriber Database Server, which do 
not need to be available on the same network. 
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The following chart compares the three methods of sharing Application Catalog data in AdminStudio and 


ConflictSolver: 
Merging Linking Replicating 
Topic (Merge Wizard) (Remote Package Alert) (Subscription and Publication) 
AdminStudio Professional Edition Professional Edition InstallShield AMS 2.0 
Edition 
Configuration = Connection between two = Connection between two = Connection between: Publisher 


Application Catalog 
Databases on the same 
network/domain. 


= Databases can be either 
MS Access or MS SQL 
Server 


Application Catalogs 
Databases on the same 
network/domain 


= Databases can be either 
MS Access or MS SQL 
Server 


and Publisher Database Server, 
Publisher Database Server and 
Subscriber Database Server, and 
Subscriber and Subscriber 
Database Server 


= Databases must be MS SQL 


Server. 


How It Works 


The source Application 
Catalog's data is merged into 
the currently open Application 
Catalog. This is a one-time- 
only database merge. The 
merged data is not linked in 
any way to the source 
Application Catalog. 


You link to individual packages 
in a remote Application 
Catalog, and these packages 
are imported into your local 
Application Catalog. When the 
remote packages are modified, 
you can update the data in 
your local Application Catalog. 


An Application Catalog database is 
distributed across a large enterprise. 
Data is replicated between the 
Publisher Database Server and 
Subscriber Database Server, which 
do not need to be available on the 
same network. 


Customers 
Who Would 
Use This 


Merging could be used in an 
organization where multiple 
people test packages. After the 
packages have been tested, all 
of the “tested” applications 
could be consolidated into one 
centralized Application 
Catalog. 


Remote Package Alert could be 
used to maintain consistency 
between applications in 
various Application Catalogs in 
organizations where they are 
satisfied with domain security 
and have both source and 
target Application Catalog 
databases on an accessible 
domain. 


Replication could be used at large 
enterprises that want to maintain a 
central Application Catalog, with 
smaller Application Catalogs at 
individual offices (such as New York, 
London, etc.). 


This method moves the data closer fo 
the user (which improves 
performance), and allows the user to 
subscribe to only the data that they 
need (which makes it easier to work 
with). 
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data in the local 
Application Catalog 


Merging Linking Replicating 
Topic (Merge Wizard) (Remote Package Alert) (Subscription and Publication) 
Advantages a Very simple = Can use MS Access = Replication provides optimal 
= Canuse MS Access databases security. Publisher Database 
databases = Can select the packages Server and Subscriber Database 
= Data is merged in with the you want to link to. Server do not need to be 


available on the same network. 
Operates within the SQL Server 
Security Model, making it a very 
secure way to replicate data— 
because the subscriber need not 
have access to the remote 
database. 


= Linked applications can be 
updated to match the 
source 


= Subscribed data coexists 
with data in local 
Application Catalog 


= AdminStudio encapsulates 
functionality from SQL Server to 
support “Snapshot” type 
replication. Using AdminStudio to 
perform Snapshot replication is 
easier than trying to perform it 
using SQL Server Enterprise 
Manager. 


= Can select individual packages in 
a Publication to subscribe to. 


= Replication is very efficient. It 
operates within the SQL Server 
Job Refresh Model, which means 
that the replication/subscription 
process is run automatically. 


= Subscribed data coexists with 
data in the local Application 


Disadvantages " Local user needs a physical 
connection to the database 
and has to have 
permissions on that remote 
database. This could allow 
the user performing the 
merge to modify the source 
database. This could cause 
a Security issue. 

m This is a one time merge 
with no link to the source 
data and no updating. 


Catalog. 
= Local user needs a physical = You can subscribe to multiple 
connection to the database subscriptions, but only one 
and has to have subscription can be active at any 
permissions on that remote one time. 


database. This could allow 
the user performing the link 
to modify the source 
database. This could cause 
a Security issue. 
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Application Catalog Replication 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


AdminStudio Application Catalog Replication makes it possible to distribute an AdminStudio Application Catalog 
database where it is needed across a large enterprise or multi-national corporation. One location can publish software 
packages to IT teams at other sites, keeping all teams current while enabling each to manage their software 
independently. 


The following topics are included in this section: 


Application Catalog Database Replication Topics 


About Application Catalog Replication 


€ 


The benefits of using Replication, an overview of creating and managing Publisher and Subscriber Application 
Catalogs, and how to configure the AdminStudio Shared Location for Replication. 


Publication/Subscription Lifecycle 


s 


Diagram illustrating how Application Catalogs are replicated 


Specialized User Scenarios 


© 


Describes how to subscribe to more than one Publication at a time, override the scheduled update day and time, and 
replicate application catalogs in controlled SQL database environments. 


Creating and Managing Publications 


€ 


Describes how to create, edit, publish, and delete a Publication. This section also explains how to set a Publication 
schedule and how to edit a Publication access list. 


Creating and Managing Subscriptions 


© 


Describes how to create, enable/disable, manually update, and delete a Subscription. 


Application Catalog Replication Reference 


= 


Describes how to use Application Catalog Replication dialogs, wizards, and command line options. This section also 
provides a list of database tables that are included and excluded in Application Catalog Database Replication. 


oN 
(m 


A 
—_ 


Only AdminStudio users who have been assigned sysadmin privileges to the currently connected SQL database server 
through the SQL Enterprise Manager can create Publications or set up Subscriptions using that database. For all other 
users, the Application Catalog Replication options are disabled. 
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About Application Catalog Replication 


w 
f ' 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


This topic lists the benefits of using Replication, provides an overview of creating and managing Publisher and 
Subscriber Application Catalogs, and explains how to configure the AdminStudio Shared Location for Replication. 


Benefits of Using Application Catalog Replication 
Using Application Catalog Replication provides the following benefits: 


E Simplifies software package management— Using Application Catalog Replication simplifies software 
management by allowing you to selectively distribute subsets of data from a master Application Catalog to multiple 
IT groups at your organization. One organization could have hundreds of applications, which would require 
multiple IT groups using AdminStudio to perform conflict detection, customization, repackaging, and testing. It 
would be unwieldy and confusing for all of those AdminStudio users to connect to the same Application Catalog. 
In this situation, it would be very beneficial for one AdminStudio user to maintain a master Application Catalog in 
a central location, and then to replicate (distribute) subsets of the data to the other IT groups. By allowing an IT 
group to work with just the data that they need, performance and efficiency is improved. 


E Allows you to distribute work geographically across the world—PFor large multi-national enterprises, 
using Application Catalog Replication allows you to distribute work geographically across the world. A large 
enterprise could maintain a central Application Catalog that is updated as applications are generated and verified 
by multiple remote IT groups on local Application Catalogs. The verified applications could then be distributed 
globally from the master Application Catalog to all the distributed work groups of the enterprise. 


= Provides optimal security— Because the Publisher Database Server and Subscriber Database Server do not 
need to be available on the same network, Application Catalog Replication provides optimal security. Replication 
operates within the SQL Server Security Model, making it a very secure way to replicate data—because the 
Subscriber need not have any access to the remote database. The minimum user requirement to configure the 
Replication feature is to have been assigned sysadmin privileges to the database server through the SQL Enterprise 
Manager. 


= Automatically performs SQL server snapshot replication—AdminStudio Application Catalog 
Replication uses SQL Server Snapshot replication method. Snapshot replication operates within the SQL Server 
Job Refresh model, which means that the replication/refresh process is run automatically. Using AdminStudio to 
perform Snapshot replication is much easier than performing it using SQL Server Enterprise Manager. 


For more information on Snapshot Replication, see the Snapshot Replication topic on the Microsoft MSDN Web site. 
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Creating and Managing Publisher and Subscriber Application 
Catalogs 


Creating Publisher and Subscriber Application Catalogs 


When creating a new SQL Server Application Catalog, you must choose (by selecting a checkbox) whether to define 
the Application Catalog as a Subscriber. 


SQL Server / MSDE Login 


Server: testlabsqiZk 


How should SQL Server verify the authenticity of the login ID? 
© With Windows NT authentication using the network login ID. 
© With SQL Server authentication using 4 login ID and password 
ent 


‘ered by the user. 
Login ID: PatriciaHowe 


Password: 


Database: Subscriber Database 


[V] Create database as a subscriber 


When this option is not selected, or when an existing database is upgraded, the Application Catalog is defined as a 
Publisher. The AdminStudio interface selectively enables/disables the Replication menu items based upon the type of 
Application Catalog that is currently opened. 


You can review your distributor properties in SQL Server Enterprise Manager on the Replication tab of the SQL Server 
Properties dialog. 


Managing Publisher and Subscriber Application Catalogs 


In AdminStudio Application Catalog Replication, data is replicated between Publisher and Subscriber databases. You 
manage the Publisher and Subscriber databases using the following two dialogs: 


= Publication Manager Dialog—Use to create and manage publications created on an AdminStudio 
Application Catalog database that is configured as a Publisher. See Managing Publications. 


E Subscription Manager Dialog—Use to create and manage Subscriptions to Publications on an AdminStudio 
Application Catalog configured as a Subscriber. See Managing Subscriptions. 


To see a diagram illustrating how data is replicated from the Publisher database to the Subscriber database, see 
Publication/Subscription Lifecycle. 
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The Publication Manager and Subscription Manager options under Replication on the Catalog menu are only enabled 
if the current user is connected to an SQL Server database and has been assigned sysadmin privileges in SQL 
Enterprise Manager on that database server. If these two things are true, the Publication Manager option is enabled 
when the database the user is currently connected to was identified when it was created as being intended for use as a 
Publisher, and the Subscription Manager option is only enabled when the database was identified as a Subscriber. See 
Create / Connect to Application Catalog Dialog for information on how to identify databases as Subscribers or 
Publishers. 


You can create as many Subscriptions or Publications as you want to, but because any previously replicated data is 

deleted whenever new Subscription data is received, the Subscriber should have only one Subscription active at any 
one time. If you want to have more than one Subscription set up at one time and switch between them, see Using the 
"Disable" Feature to Subscribe to More Than One Publication for more information. 


Configuring the AdminStudio Shared Location for Replication 


When Publishing data using Application Catalog Replication, the Publication Server needs access to two script files 
that are installed in the AdminStudio Shared Directory Location. Therefore, the AdminStudio Shared Directory 
Location should refer to a network folder, making it accessible to the Publication Server. See Specifying the 
AdminStudio Shared Directory Location. 


Initial Configuration Checklist 


Before you can use Application Catalog Replication, you need to perform the following steps to configure the 
Subscriber and Distributor databases at your organization. If the Subscriber and Distributor databases are not 
configured in this manner, Replication will fail. 


The Publisher server is often configured as its own Distributor server. 


To configure the Subscriber and Distributor servers: 


1. Check the SQL Server Agent logins configured on the Subscriber and Distributor databases, and make 
sure that the SQL Server Agent on the Subscriber database can login to the Distributor database via the 
Distributor SQL Server Agent using the distributor_admin login. 


2. Configure a Distributor database for the servers that are publishing data. 
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Publication/Subscription Lifecycle 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Application Catalog database replication process is detailed in the diagram and notes below, including creating 
and publishing a Publication, and subscribing to that Publication. 


Publisher 


Local Publisher 
Database Server 


Step Description 
Publisher Steps 
Step 1: Create Publication The Publisher—an AdminStudio user who wants to make part of his Application Catalog 


available for Publication—creates a Publication on the local Publisher Database Server. 
The Publisher must have been assigned sysadmin privileges in SQL Enterprise Manager 
on the Publisher Database Server. 


Step 2: Define Update The Publisher defines the automatic update schedule for the Publication. At the specified 
Schedule date and time, the Publisher Database Server will check the Application Catalog to see if 
any published data has changed. If newer data exists, the Publication will be updated. 


Step 3: Publish Publication The Publisher generates the initial Publication by clicking the Run button on the 
Publication Manager dialog. The Publication is now available for Subscription. 
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Step 


Description 


Subscriber Steps 


Step 4: Subscribe to 
Publication 


The Subscriber—an AdminStudio user who wants to receive data from the Publisher's 
Application Catalog—creates a Subscription to that Publication. The Subscriber must 
have been assigned sysadmin privileges in SQL Enterprise Manager on the Subscriber 
Database Server. 


Step 5: Define Update 
Schedule 


The Subscriber defines the automatic update schedule for the Subscription. At the 
specified date and time, the Subscriber Database Server will check to see if the 
Subscription on the Publisher Database Server has been updated. If it has been updated, 
the Subscription on the Subscriber Database Server will be updated. 


Step 6: Data is Copied to 
Application Catalog 


The subscribed Publication is copied to the Subscriber Database Server, and is listed 
under the Replication group in the Subscriber's Application Catalog (when viewed in the 
ConflictSolver products explorer). 


Terminology Review 


The following terminology was used in this diagram and is used throughout the Application Catalog Replication help 


topics: 
Term Definition 
Publisher Person who creates the Publication. 
Local Publisher Database Server A Database Server making data available for replication. 
Publication The actual data made available for replication. 
Subscriber Person who subscribes to a publication. 
Subscriber Database Server A Database Server that receives the replicated data. 
Subscription A request to receive a Publication from a Distributor. 
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Specialized User Scenarios 


© 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The following topics explain how to use the Application Catalog Database Replication feature to best meet your 
organization's needs. 


Using the "Disable" Feature to Subscribe to More Than One 
Publication 


At your organization, it could be beneficial to have more than one Subscription configured in the Subscription 
Manager, allowing you to switch from one Subscription to another, even though only one Subscription can be active 
and listed in your Application Catalog at any one time: the one that has been executed (updated) the most recently. 


You might want to set up multiple Subscriptions in a situation where an IT group wants to work on a specific group 
of applications at a time. For example, an IT group might want to perform conflict analysis on Accounting 
applications one week and on Marketing applications the next week. When the IT group finishes work on the 
Accounting applications, the "Accounting" Subscription would be disabled and the "Marketing" Subscription would 
be enabled. By having multiple Subscriptions configured, local users can quickly switch between tasks. 


On the Subscription Manager Dialog, Subscriptions that are enabled are preceded by a check mark (v), while disabled 
Subscriptions are preceded by a red X (%) 


You use the Enable/Disable button on the Subscription Manager dialog to set the status of each Subscription to be 
either Enabled or Disabled. When you disable a Subscription, you are turning off its automatic update feature. Since 
Subscriptions are updated automatically, and since all of the currently active Subscription's data is replaced when a 
Subscription is updated, if you have multiple Subscriptions, it is to your advantage to disable all except the one you are 
currently using. This allows you to work on one set of data and control when that data is changed. If you have more 
than one Subscription enabled at a time, when the second enabled Subscription is automatically updated at its 
scheduled time, it will replace the data of the Subscription you were currently using. 


Overriding the Scheduled Update Day and Time 
If you want to manually update either Publication data or Subscription data before its scheduled update time, you can 


use the Run button on the Subscription Manager and Publication Manager Dialogs. Using the Run button forces the 
selected Publication or Subscription to refresh itself. 
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Replicating Application Catalogs in Controlled SQL Database 
Environments 


Some companies that have a controlled SQL database environment prefer to have their database administrators make 
major changes to their databases. In this case, you could select the Generate publication as script option on the 
Publication Summary Panel of the Publication Wizard or the Generate subscription as script option on the 
Subscription Summary Panel of the Subscription Wizard so that the Wizard would generate an SQL script of the code 
necessary to create this Publication or Subscription rather than actually create it. 


When this option is selected, the script is the only output of the Wizard and the new item is not listed on the 
Publication Manager or Subscription Manager. The Database Administrator could then run this script to create the 
Publication or Subscription. 


To create Publications and Subscriptions using SQL Server Enterprise Manager, perform the following steps: 


(gs 


C 7 


To create publications and subscriptions using SQL Server Enterprise Manager: 


1. Use the Publication Wizard or Subscription Wizard to generate an SQL script by selecting the 
Generate as script option on the Summary Panel. 


2. Copy the script to your server. 
3. Open Query Analyzer. 
4. Select the database you want to work with. 


5. Open the script file that was generated, and examine the sp_addpublication stored procedure to make 
sure that the PreReplication.sql and PostReplication.sql scripts are accessible from the system running 
Enterprise Manager. If they are not accessible, copy the scripts to an accessible location, and update 
the sp_addpublication stored procedure with the revised path names. 


6. Execute the script. 
7. Return to SQL Server Enterprise Manager. 


8. If you created a Publication, open the database that you just generated the publication for and 
publish it. 
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Creating and Managing Publications 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


A Publication describes a subset of a database that you want to copy to a specific location to make it available to 
Subscribers. When a Publication is published, the data is copied to that accessible location. You create Publications to 
meet the needs of your subscribers. The Publication can be a partial Application Catalog—perhaps containing only 10 
out of the 200 applications in your Application Cataloge—or it can be an exact replica of your Application Catalog. 


This section describes how to create, edit, publish, and delete a Publication, and also how to set a Publication schedule 
and edit a Publication access list. 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


You create, publish, edit, and delete Publications using the Publication Manager Dialog. 


testlabsql2k (HowePublisher 2004) - sa - Publication Manager 


Publications: 


| Name Description Status Last Action LastRun Next Run 


| Orca Orcates... Nev... Never... 1/6/2004 3:35:20 PM 
Pack... Internet... Nev... Never... 1/6/2004 3:37:40 PM 


The Publication Manager, which lists all Publications in the SQL Server database you are currently connected to, is 
accessed by pointing at Replication on the Catalog menu and selecting Publication Manager. 
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J 
The Publication Manager option under Replication on the AdminStudio Interface Catalog menu is only enabled if the 
current user is connected to an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise 
Manager on that database server, and the database was identified when it was created as being intended for use as a 


Publisher. See Create / Connect to Application Catalog Dialog for information on how to identify databases as 
Subscribers or Publishers. 


me 


The Publication Manager lists the last time that each of the Publications was updated (published to the Publisher 
Database Server) and the next scheduled update time for that Publication. From the Publication Manager, you can 
perform the following tasks: 


m Create a New Publication—Click the New button to create a new Publication using the Publication Wizard. 


m Edit an Existing Publication—Select a Publication and click Edit to access the Publication Properties Dialog, 
where you can edit the selected Publication's description, update schedule, user access list, and the packages 
included in the Publication. 


m Publish a Publication—Select a Publication and click Run to manually update the selected Publication. The 
Publication data is replicated from your Application Catalog to the Publisher Database Server, making it available 
to Subscribers. 


= Delete a Publication—Select a Publication and click Delete to delete the Publication data from the Publisher 
Database Server, making it no longer available for Subscription. When the list on the Publication Manager is 
refreshed, the Publication will no longer be listed. 
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Creating a New Publication 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


To create a Publication, you use the Publication Wizard to select the packages that you want to include in the 
Publication, specify the users that you want to be able to access the Publication, and schedule how often you want the 
Publication to be automatically updated. When the Publication Wizard is complete, the SQL Server is configured for 
this Publication, and the name of the Publication is listed on the Publication Manager Dialog. 


To create a new Publication: 


1. On the Catalog menu, point to Replication and select Publication Manager. The Publication Manager 
Dialog appears. 


testlabsql2k (HowePublisher 2004) - sa - Publication Manager 


Publications: 


Name Description Status Last Action LastRun Next Run 


Orca tes... Nev... Never... 1/6/2004 3:35:20 PM 
. Internet... Nev... Never... 1/6/2004 3:37:40 PM 


The Publication Manager option under Replication on the Catalog menu is only enabled if the current user is 
connected fo an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise Manager on 
that database server, and the database was identified when it was created as being intended for use as a 
Publisher. See Create / Connect to Application Catalog Dialog for information on how to identify databases 
as Subscribers or Publishers. 
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2. Click New. The Welcome Panel of the Publication Wizard appears. 


Publication Wizard 
Welcome to the Publication Wizard 
Nae The Publication wizard will walk through the options for 
creating a SQL Server publication from an ‘Application 
Catalog’. 


Click 'Next' to continue. 


Publication Wizard 


Publication Details 
Specify the properties of the publication. 


The publication requires certain specific properties in order to be created. Specify the requested 
properties and click 'Next' to continue. 


Description: 


Schedule: 


[Once daily starting on: 1/5/20043:43:37PM 22O Ol 


4. In the Name text box, enter a name to identify this new Publication. This name will be listed on the 
Publication Manager Dialog. 


The Publication Name cannot be a T-SQL reserved word. 


5. In the Description text box, enter text to describe the purpose of this new Publication. This description 
will be listed on the Publication Manager Dialog. 
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6. Click Change next to the Schedule text box. The Task Scheduling Dialog appears. 


Task Scheduling 


The publishing process will execute according to the schedule you specify. 


Run the process every: von Every Day 


At: 3:43:37 PM 


Starting on: Monday , January 05, 2004 


7. In the Run the process every list, select how frequently you want this Publication to be automatically 
updated on the Publisher Database Server: Day, Week, or Month. 


m |f you selected Week, select the day of the week that you want to update this Publication. 


m |f you selected Month, select the day of the month that you want to update this Publication. 


8. From the Starting on list, select the day or date that you want this Publication to begin being 
automatically updated on the day or date you selected from the Run the process every list. 


For example, if you want the Publication to be automatically updated on the 15th of each month, you 
would select the first day of the first month that you want the automatic updates to begin, not the first 
day that the Publication should be updated. If it is Monday and you want the Publication to be updated 
every Friday, to have the Publication begin being updated on the upcoming Friday, you would select 
the current day of the week (Monday), but if you didn't want the Publication to be updated until the 
Friday after next, you would select Saturday. 


9. Click OK to exit the Task Scheduling dialog. 
10. Click Next. The Publication Data Options Panel appears. 


Publication Wizard 


Publication Data Options 
Specify the particular types of data to include in the publication. 


Select the types of data you wish to include in the publication and click 'Next' to continue. 
Publication Data Type Options 


Sy aaa 
All groups and your choice of packages will be included in the publication, 


[C] Merge Module Data 
All Merge Module data will be included in the publication. 
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11. Select the types of data you want to include in the Publication: 


= Groups and Package Data— Select this option if you want to select a specific set of packages 
from the various Groups in the Application Catalog to include in the Publication. If you select this 
option, the Publication Packages Panel will appear, prompting you to select which packages you 
want to include in the Publication. If you do not select this option, all Groups and all packages within 
those Groups will be included in the Publication. 


m Merge Module Data— Select this option if you would also like to include all Merge Modules 
associated with the packages you have selected in the Publication. If you do not select this option, 
the Merge Module data will not be included in the Publication. 


12. Click Next. The Publication Access List Panel appears. 


Publication Wizard 


Publication Access List 
Specify the recipients of the publication. 


Specify the list of users allowed to access this publication and click 'Next' to continue. 


Users: 


Amber1 

ASAdmin 

BUILTIN ‘Administrators 

distributor_admin 

NansSGLSysadmin 

sa 

testlab 

TESTLABSGL\NansSysAdmin ~i 


Cra Jone) (Coane) Cle 


13. On this panel, specify the list of users allowed to access this Publication. It initially shows a list of users 
who have the necessary privileges to access the Publication: those users who have been assigned 
sysadmin privileges to this database server through the SQL Enterprise Manager. To remove a user, 
select it and click Remove. 


Only users that have been assigned sysadmin privileges in SQL Enterprise Manager to the connected database 
server can establish the Publisher-Subscriber relationship between the databases and are therefore listed on this 
panel. You can remove a user from this list (so that they will not be able to access this Publication), but you cannot 
add additional users to this list using AdminStudio. To add new users, you must use SQL Enterprise Manager. 


InstallShield Software Corporation © 2004 148 


AdminStudio 5.5 User Guide 4 Sharing Application Catalog Data 


14. Click Next. If you selected the Groups and Package Data option, the Publication Packages Panel 
appears. 


Publication Wizard 


Publication Packages 
Specify the packages destined for publication. 


Select packages for inclusion in the publication and click 'Next' to continue. 


2 00 Groups 
DA Orca v1.50.2600.0000 
OG PackageFoTheweb 4 v4.0.0 


ee re 


15. On the Publication Packages Panel, the Groups and Packages in the Publisher Application Catalog 


database you are connected to are listed. Select the Groups and packages that you want to include in 
this new Publication and click Next 


The Publication Summary Panel appears, providing a detailed summary of the options that were 
selected in previous panels of the Wizard. 


Publication Wizard 


Publication Summary 
Review your selected publication options. 


Click 'Finish' and a publication with the following options will be created. 


General Publication Information 
PackageForTheweb5 
Latest release 
Once daily starting on: 1/5/2004 3:43:37 PM 


Data Types Selected 
Groups and Packages Data: 
Merge Module Data: 


oë 2 


[C] Publish the publication immediately after creation 


EEEE (omnes) mE 


C:\Program Files\InstallShield\AdminS tudi | 


16. If you would like to generate an SGL script of the code necessary to create this Publication rather than 
actually create it, select the Generate publication as script option, and enter a path name for the script 


file. 
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You might want to use this option if your organization has a controlled SQL database environment that prefers 
to have their database administrators make major changes to their databases. See Replicating Application 
Catalogs in Controlled SQL Database Environments for more information. 


17. To choose to publish this Publication immediately upon completion of the Publication Wizard (instead of 
publishing it manually or waiting until its scheduled update), select the Publish the publication 
immediately after creation option. 


18. Click Finish to complete the creation of this Publication. 


m |f you did not select the Generate publication as script option, the new Publication is listed on 
the Publication Manager. 


m |f you selected the Generate publication as script option, you will receive a message that the 
script was generated properly. When you close that message, you will see that this Publication is not 
listed on the Publication Manager. Request that your Database Administrator run the SQL script that 
you just generated in order to create this Publication. 


19. Proceed with steps under Publishing a Publication. 


InstallShield Software Corporation © 2004 150 


AdminStudio 5.5 User Guide 4 Sharing Application Catalog Data 


© 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When you publish a Publication, you are initiating a manual replication of the Publication data from your Application 
Catalog to the Publisher Database Server, making it available for Subscription. After its initial Publication, the 
Publication is also automatically "re-published" (updated) according to the schedule specified when the Publication 
was created. 


To publish a Publication: 


1. On the Publication Manager, select the Publication that you want to publish. 


If you did not select the Generate publication as script option on the Publication Summary Panel of the 
Publication Wizard, the Publication should be listed on the Publication Manager as soon as the Publication 
Wizard finishes. If the Publication you want to publish is not listed here, make sure that the Publication Wizard 
was completed and, if the Generate publication as script option was selected, check with your Database 
Administrator to see if the script has been run. 


2. Click Run. 


The Publication data is replicated from your Application Catalog to the Publisher Database Server, 
making it available for Subscription. 
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Setting a Publication Schedule 
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Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When you create a Publication, you specify how frequently you want this Publication to be automatically updated on 
the Publisher Database Server. If you would like to change this frequency, you can edit the Publication from the 
Publication Manager Dialog. 


# 
f 


` 
'i gı \ 


= 
| (g2 | 
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To set a Publication schedule: 


6. 


7. 


On the Publication Manager, select the Publication that you want to edit and click Edit. The Publication 
Properties Dialog appears. 


Click the Details tab. 
Click Change next to the Schedule text box. The Task Scheduling Dialog appears. 


In the Run the process every list, select how frequently you want this Publication to be automatically 
updated on the Publisher Database Server: Day, Week, or Month. 


m |f you selected Week, select the day of the week that you want to update this Publication. 


m |f you selected Month, select the day of the month that you want to update this Publication. 


From the Starting on list, select the day or date that you want this Publication to begin being 
automatically updated on the day or date you selected from the Run the process every list. 


For example, if you want the Publication to be automatically updated on the 15th of each month, you 
would select the first day of the first month that you want the automatic updates to begin, not the first 
day that the Publication should be updated. If it is Monday and you want the Publication to be updated 
every Friday, to have the Publication begin being updated on the upcoming Friday, you would select 
the current day of the week (Monday), but if you didn't want the Publication to be updated until the 
Friday after next, you would select Saturday. 


Click OK to exit the Task Scheduling dialog. 


Click OK to exit the Publication Properties dialog. 
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[E > 
| w -— 
Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


You can edit an existing Publication from the Publication Manager Dialog. 


To edit a Publication: 


1. On the Publication Manager, select the Publication that you want to edit and click Edit. The Publication 
Properties Dialog appears. 


2. Click the Details tab. 


3. In the Description text box, enter text to describe the purpose of this Publication. This description will be 
listed on the Publication Manager and Subscription Manager dialogs. 


4. In the Schedule field, specify how often you would like this Publication to be automatically updated. 
Click the Change button to access the Task Scheduling Dialog, where you can edit how frequently this 
Publication will be automatically updated. 


5. If the Groups and Package Data option was selected on the Publication Data Options Panel when this 
Publication was created, you can click the Packages tab and select or unselect packages for inclusion 
in the Publication. 


6. Click OK to exit the Publication Properties dialog. 
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Editing a Publication Access List 


© 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When you create a Publication, you specify the list of users allowed to access this Publication. If you would like to 
alter this list, you can edit the Publication from the Publication Manager Dialog. 


To edit a Publication Access List: 


1. On the Publication Manager, select the Publication that you want to edit and click Edit. The Publication 
Properties Dialog appears. 


2. Click the Access List tab. The Access List tab lists users who have the necessary privileges to access the 
Publication: those users who have been assigned sysadmin privileges to this database server through 
the SQL Enterprise Manager. 


3. Select the users allowed to access this Publication. To remove a user, select it and click Remove. 


Only users that have been assigned sysadmin privileges in SQL Enterprise Manager to the connected 
database server can establish the Publisher-Subscriber relationship between the databases and are therefore 
listed on this panel. You can remove a user from this list (so that they will not be able to access this 
Publication), but you cannot add additional users to this list using AdminStudio. To add new users, you must 
use SQL Enterprise Manager. 


4. Click OK to exit the Publication Properties dialog. 
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Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When you no longer want to have a Publication available for Subscription, you can delete it using the Delete button 
on the Publication Manager Dialog. 


gis 
B 
To delete a Publication: 


1. On the Publication Manager Dialog, select the Publication that you want to delete. 


2. Click Delete. A dialog appears asking you to confirm the deletion. 
3. Click OK. 


The Publication data is deleted from the Publisher Database Server, and when the list on the Publication 
Manager is refreshed, the Publication will no longer be listed. 
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Creating and Managing Subscriptions 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The topics in this section explain how to create a Subscription, edit its update schedule, enable or disable it, and 
update it manually. Please note the following about Subscriptions: 


= Subscribed data can co-exist with local data—A Subscriber's Application Catalog can contain its own 
packages and can also contain subscribed Publications containing packages. The subscribed Publication is listed 
under the Replication group in the Subscriber's Application Catalog (when viewed in the ConflictSolver products 
explorer). 


= Subscribed data is effectively read-only—You should consider a Subscription as read-only data. Each 
time Subscription data is updated, it is completely replaced, so all changes that were made on a local copy of the 
Subscription data would be lost. 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


You use the Subscription Manager Dialog to view Subscription information, create new Subscriptions, disable a 
Subscription so that it is not automatically updated, manually update a Subscription, and delete a Subscription. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


| Publisher Publisher Database Publication Description 
Matestlabsql2k HowePublisher2004 Orca Orca testing appli... Enabled 
X testlabsql2k HowePublisher2004 PackageForTheWeb Internet application Disabled 


The Subscription Manager, which lists all Publications that are currently subscribed to, is accessed by pointing at 
Replication on the Catalog menu and selecting Subscription Manager. 
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The Subscription Manager option under Replication on the AdminStudio Interface Catalog menu is only enabled if the 
current user is connected to an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise 
Manager on that database server, and the database was identified when it was created as being intended for use as a 


Subscriber. See Create / Connect to Application Catalog Dialog for information on how to identify databases as 
Subscribers or Publishers. 


The Subscription Manager lists the last time that each of the Subscriptions was updated, the next scheduled update 
time for that Subscription, and whether the Subscription is enabled (active) or disabled. From the Subscription 
Manager, you can perform the following tasks: 


m Create a New Subscription—Click the New button to create a new Subscription using the Subscription 
Wizard. 


= Enable or Disable a Subscription—Click the Enable/Disable button to toggle the selected Subscription's 


status between Enabled and Disabled. When you disable a Subscription, you are turning off its automatic update 
feature. 


While you can subscribe to multiple Subscriptions, only one Subscription can be active and listed in your Application 
Catalog at any one time: the one that has been executed (updated) the most recently. For information on how to use the 
Disable feature to subscribe to more than one Application Catalog, see Specialized User Scenarios. 


= Manually Update a Subscription—Click Run to manually update the selected Subscription. The 


Subscription Manager will then replace the data of the Application Catalog's currently active Subscription with the 
most recent version of the selected Subscription's data. 


m Delete a Subscription—Click Delete to delete the selected Subscription from the Subscription Manager. When 
the list on the Subscription Manger is refreshed, the Subscription will no longer be listed. 
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Creating a New Subscription 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


To create a Subscription, use the Subscription Wizard to select the Publisher database that you want to subscribe to, 
and schedule how often you want the Subscription to be automatically updated. When the Subscription Wizard is 


complete, the replicated Publication data is copied into your Application Catalog, and the name of the Subscription is 
listed in the Subscription Manager Dialog. 


To create a new Subscription: 


1. On the Catalog menu, point to Replication and select Subscription Manager. The Subscription 
Manager Dialog appears. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


Publisher Publisher Database Publication Description 
Matestlabsql2k HowePublisher2004 Orca Orca testing appli... Enabled 
X testlabsql2k HowePublisher2004 PackageForTheWeb Internet application Disabled 


The Subscription Manager option under Replication on the Catalog menu is only enabled if the current user is 
connected to an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise Manager on 
that database server, and the database was identified when it was created as being intended for use as a 
Subscriber. See Create / Connect to Application Catalog Dialog for information on how to identify databases 
as Subscribers or Publishers. 
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2. Click New. The Welcome Panel of the Subscription Wizard appears. 


Subscription Wizard 
Welcome to the Subscription Wizard 
> The Subscription wizard will walk through the options for 
creating a SOL Server subscription to an ‘Application 
Catalog’. 


Click 'Next' to continue. 


Subscription Wizard 


Subscription Details 
Specify the specific options associated with the subscription. © 


The subscription requires certain specific properties in order to be created. Specify the 
requested properties and click 'Next' to continue. 


Database: 


{testlabsql2k (HowePublisher2004) - sa 
Schedule: 


[Once daily starting on: 1/5/2004 4:2925PM == ss Change... | 


EE (reo) 
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4. Click the Change button next to the Database field. The SQL Server / MSDE Login Dialog appears. 


SQL Server / MSDE Login 


Server: | TESTLABSQL2K 


How should SQL Server verify the authenticity of the login ID? 
Ov With Windows NT authentication using the network login ID, 


@ With SQL Server authentication using a login ID and password 
entered by the user. 


Login ID: 


Password: 


Database: | 4531 WorkFlow 


5. Select the Server and Database name of the Publication database (which was identified as being 
intended for use as a Publisher database when it was created), and click OK. You are returned to the 
Subscription Details Panel, and the database you selected is now listed in the Database field. 


6. Click Change next to the Schedule text box. The Task Scheduling Dialog appears. 


Task Scheduling 


The publishing process will execute according to the schedule you specify. 


Run the process every: | on ‘Every Day 


At; 3:43:37 PM 


Starting on: Monday , January 05, 2004 


7. In the Run the process every list, select how frequently you want this Subscription to be automatically 
updated: Day, Week, or Month. 


m |f you selected Week, select the day of the week that you want to update this Publication. 


m |f you selected Month, select the day of the month that you want to update this Publication. 


8. From the Starting on list, select the day or date that you want this Publication to begin being 
automatically updated on the day or date you selected from the Run the process every list. 


For example, if you want the Publication to be automatically updated on the 15th of each month, you 
would select the first day of the first month that you want the automatic updates to begin, not the first 
day that the Publication should be updated. If it is Monday and you want the Publication to be updated 
every Friday, to have the Publication begin being updated on the upcoming Friday, you would select 
the current day of the week (Monday), but if you didn't want the Publication to be updated until the 
Friday after next, you would select Saturday. 


9. Click OK to exit the Task Scheduling dialog. You are returned to the Subscription Details Panel, and the 
schedule you specified is now listed in the Schedule field. 
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10. Click Next. The Subscription Selection Panel appears, which displays the Publications available from 
the selected Publisher database that satisfy the Publication Access List requirements for this user. In other 
words, it lists the Publications that you have permission to subscribe to. 


Subscription Wizard 


Subscription Selection 
Selection the publication to subscribe. 


Select one publication to subscribe to and click 'Next' to continue. 


Available Publications for 'testlabsql2k (HowePublisher2004) - sa’: 


Name Description 

Orca Orca testing application 
PackageForTheWeb Internet application 
PackageForTheWeb5 Latest release 

Orca 6 Latest release 
PackageForTheWeb 6 Latest release 


(cae Jue) ee (ie) 


11. Select one Publication from this list to subscribe to and click Next. The Subscription Summary Panel 
appears, providing a detailed summary of the options that were selected in previous panels of the 


Wizard. 


Subscription Wizard 


Subscription Summary 
Review your selected subscription options. 


Click ‘Finish’ and a subscription with the following options will be created. 


Subscription Details 


Publisher: 

Publisher Database: 
Publication: 

Publication Description: 


testlabsql2k 
HowePublisher2004 
PackageForT he\Wweb 
Internet application 


Subscription Datatabase 
Database Server: 
Database Name: 
Database User: 


testlabsql2k 
HoweSubscriber2004 
sa 


Ce e omen) (oem) 


12. If you would like to generate an SGL script of the code necessary to create this Subscription rather than 
actually create it, select the Generate subscription as script option, and enter a path name for the script 


file. 
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You might want to use this option if your organization has a controlled SQL database environment that prefers 
to have their database administrators make major changes to their databases. See Replicating Application 
Catalogs in Controlled SQL Database Environments for more information. 


13. Click Finish to complete the creation of this Subscription. 


Enabling/Disabling a Subscription 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


You can use the Enable/Disable button on the Subscription Manager Dialog to set the status of each Subscription to 
be either Enabled or Disabled. When you disable a Subscription, you are turning off its automatic update feature. 
Subscriptions that are enabled are preceded by a check mark (v), while disabled Subscriptions are preceded by a red 
X (x). 


@ 


For information on how you can use the Disable feature to subscribe to more than one Publication, see Specialized User 
Scenarios. 
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— 
To enable or disable a Subscription: 
1. On the Catalog menu, point to Replication and select Subscription Manager. The Subscription 


Manager Dialog appears, listing all of your Subscriptions. Each Subscription's status (Enabled or 
Disabled) is displayed in the Last Run Status column. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


Publisher Publisher Database Publication Description 
Matestlabsql2k HowePublisher2004¢ Orca Orca testing appli... Enabled 
X testlabsql2k HowePublisher2004¢ PackageForTheWeb Internet application Disabled 


The Subscription Manager option under Replication on the Catalog menu is only enabled if the current user is 
connected fo an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise Manager on 


that database server, and the database was identified when it was created as being intended for use as a 


Subscriber. See Create / Connect to Application Catalog Dialog for information on how to identify databases 
as Subscribers or Publishers. 


2. To disable an enabled Subscription, select it and click Disable. 


The Subscription's status in the Last Run Status column is changed to Disabled, meaning that the 
Subscription will still be listed in the Subscription Manager, but will not be automatically updated. 


This button toggles between Enable and Disable, depending upon the Status of the selected Subscription. 


3. To enable a disabled Subscription, select it and click Enable. 
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Manually Updating a Subscription 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


If you want to update a subscribed Publication to match the Publication on the Publisher Database Server and you do 
not want to wait until the next scheduled automatic update is performed, you can use the Run button on the 
Subscription Manager Dialog to manually update a Publication. 


To delete a Subscription: 


1. On the Subscription Manager, select the Publication that you want to update. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


Publisher Publisher Database Publication Description Status 
Matestlabsql2k HowePublisher2004 Orca Orca testing appli... Enabled 
X testlabsql2k HowePublisher2004 PackageForTheWeb Internet application Disabled 


2. Click Run. The Publication is replicated from the Publisher Database Server, replacing the earlier 
version. 


You can only update a subscribed Publication that has already been published at least once. If the Publication 
has never been published, the update will fail. 
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Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When you no longer want to subscribe to a Publication, you can Delete it from the Subscription Manager dialog. 


x- 
To delete a Subscription: 


1. On the Subscription Manager, select the Subscription that you want to delete. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


Publisher Publisher Database Publication Description 


Matestlabsql2k HowePublisher2004 Orca Orca testing appli... Enabled 
X testlabsql2k HowePublisher2004 PackageForTheWeb Internet application Disabled Disable 


2. Click Delete. A dialog appears asking you to confirm the deletion. 


3. Click OK. The Subscription's name is deleted from the Subscription Manager List. 
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Application Catalog Replication Reference 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


This Reference section contains information on Application Catalog Replication dialogs, wizards, command line 
options, and tables. 


Application Catalog Replication Dialogs 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Publication Manager lists all Publications in the SQL Server database you are currently connected to. Use this 
dialog to create, edit, publish, or delete a Publication. 


testlabsql2k (HowePublisher 2004) - sa - Publication Manager 


Publications: 


| Name Description Status Last Action LastRun Next Run 


Orca =Orcates... Nev... Never... 1/6/2004 3:35:20 PM 
Pack... Internet... Nev... Never... 1/6/2004 3:37:40 PM 
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The Publication Manager option under Replication on the AdminStudio Interface Catalog menu is only enabled if the 
current user is connected to an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise 
Manager on that database server, and the database was identified when it was created as being intended for use as a 
Publisher. See Create / Connect to Application Catalog Dialog. 


Field Description 

Name Name of the Publication. 

Description Description of the Publication. 

Status The status of the last attempted update of the Publication: Succeeded or Failed. If the update is currently 
being executed, Executing appears in this column. 

Last Action Text describing the last action that was performed on this Publication. 

Last Run The date and time that the Publication was last updated. 

Next Run The next scheduled update time of that Publication. 

New Click to create a new Publication using the Publication Wizard. 

Edit Click to access the Publication Properties Dialog, where you can edit the selected Publication's name, 
description, scheduled update day and time, the type of data you want fo include in the Publication, the 
list of users allowed to access the Publication, and the packages included in the Publication. 

Run Click to manually update the selected Publication. The Publication data is replicated from your 
Application Catalog to the Publisher Database Server, making it available for Subscription. 

Delete Click to delete the selected Publication from the Publication Manager. 


If an attempt to create a Publication fails, it could be because your Publication server does not have a Distributor server 
configured. For more information, see Initial Configuration Checklist. 
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Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Publication Processing dialog appears after you click Finish on the Publication Summary Panel of the Publication 
Wizard. 


Processing... 


Creating the publication 
Creating the snapshot agent 
Adding to the publication access list 


Adding articles to the publication 


The Publication Processing dialog tracks the progress of the Publication Wizard as the Publication is created, the 
snapshot agent is created, the permissions are added to the Publication Access List, and articles are added to the 
Publication. 


When processing is finished, the new Publication is listed on the Publication Manager Dialog. 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Publication Properties dialog, which is accessed by clicking Edit on the Publication Manager Dialog, allows you 
to edit the selected Publication's name, description, scheduled update day and time, the type of data you want to 
include in the Publication, the list of users allowed to access the Publication, and the packages included in the 
Publication. 


Publication Properties 


Details | Options | Access List | Packages | 


The publication requires certain specific properties. Specify values for the requested properties 
before continuing. 


Name: 


Description: 


Internet application 
Schedule: 


Once dail starting on: 1/5/2004 3:37:40 PM ; | 


ae E | 
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The Publication Properties dialog contains the following tabs: 


Publication Properties Tab Fields & Description 


Details Tab This tab contains the following properties: 


a Name—Nazme that identifies this Publication. This field is read-only. 


= Description—Enter a description of the purpose or intended subscribers to this 
Publication. This description will be listed on the Publication Manager. 


= Schedule—lIn this field, you specify how often you would like this Publication to be 
automatically updated. Click the Change button to access the Task Scheduling 
Dialog, where you can specify how frequently the Subscription will be automatically 
updated. 


Options Tab Specify the following Publication data type options: 


= Groups and Package Data-— Select this option if you want to select a specific set 
of packages from the various groups in the Application Catalog to include in the 
Publication. If you select this option, the Publication Packages Panel will appear, 
prompting you to select packages to include in the Publication. If you do not select 
this option, all groups and all packages within those groups will be included in the 
Publication. This field is read-only. 


a Merge Module Data-— ‘Select this option if you would also like to include all Merge 
Modules associated with the packages you have selected in the Publication. 


Access List Tab Specify the list of users allowed to access this Publication. It initially shows a list of users 
who have the necessary privileges fo access the Publication: those users who have been 
assigned sysadmin privileges to this database server through the SQL Enterprise 
Manager. You can remove users from the list. See Publication Access List Panel for more 
information. 


Packages Tab If Groups and Package Data is selected on the Options tab, this tab lists the Groups and 
Packages in the SQL database you are connected to. Select the packages that you want 
to include in this Publication. See Publication Packages Panel for more information. 
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Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Subscription Manager lists all Publications that you are subscribed to in the SQL Server database you are 
currently connected to, and displays their Enable/Disable status. 


testlabsql2k (HoweSubscriber 2004) - sa - Subscription Manager 


Subscriptions: 


Publisher Publisher Database Publication Description Status 
| Matestlabsql2k HowePublisher2004 Orca Orca testing appli... Enabled 
| X testlabsql2k HowePublisher2004 PackageForTheWeb Internet application Disabled 


Disable 


Use this dialog to view Subscription information, create a new Subscription, disable a Subscription so that it is not 
automatically updated, manually update a Subscription, and delete a Subscription. 


While you can subscribe to multiple Subscriptions, only one Subscription can be active and listed in your Application 
Catalog at any one time: the one that has been executed (updated) the most recently. For information on how to use 
the Disable feature on the Subscription Manager to subscribe to more than one Application Catalog, see Specialized 
User Scenarios. 


The Subscription Manager option under Replication on the Catalog menu is only enabled if the current user is 
connected fo an SQL Server database, has been assigned sysadmin privileges in SQL Enterprise Manager on that 
database server, and the database was identified as being intended for use as a Subscriber when it was created. See 
Create / Connect to Application Catalog Dialog for information on how to identify databases as Subscribers or 
Publishers. 
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The Subscription Manager dialog contains the following fields: 


Field Description 

Publisher Name of the Publisher Database Server. 

Publisher Database Name of the database on the Publisher Database Server containing the Publication. 

Publication Name of the subscribed Publication. 

Description Description of the subscribed Publication that was entered by the creator of the Publication. 

Status The status of the last attempted update of the Publication: Succeeded or Failed. If the update is 
currently being executed, Executing appears in this column. 

Last Action Text describing the last action that was performed on this Subscription. 

Last Run The date and time that the Subscription was last updated. 

Next Run The next scheduled update time of that Subscription. 

New Click to create a new Subscription using the Subscription Wizard. 

Enable/Disable Click to toggle the selected Subscription's status between Enabled and Disabled. When you 
disable a Subscription, you are turning off its automatic update feature. 

Subscriptions that are enabled are preceded by a check mark (¥), while disabled Subscriptions 
are preceded by a red X (x). For more information, see Specialized User Scenarios. 

Run Click to manually update the selected Subscription. The Subscription Manager will then replace the 
data of the Application Catalog's currently active Subscription with the most recent version of the 
selected Subscription's data. When a disabled Subscription is selected, the Run button is disabled. 
For more information, see Specialized User Scenarios. 

Delete Click to delete the selected Subscription from the Subscription Manager. 


AN 


If you are unable to receive a Subscription, the most likely cause is that the Publication has not been published. Check 
to find out if the Publication has been published. 
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Task Scheduling 


v 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


This dialog is used to specify how frequently a Publication or Subscription will be automatically updated. Both the 
Publication Manager and Subscription Manager require schedule information. This dialog is invoked by clicking the 
Change button on the Details Panel of the Publication and Subscription Wizards, and the Details tab of the 
Publication Properties Dialog. 


Task Scheduling 


The publishing process will execute according to the schedule you specify. 


Run the process every: v| on Every Day 


At: 3:43:37 PM 


Starting on: Monday , January 05, 2004 


A Publication's update frequency can be changed after the Publication is created by accessing the Details tab of the 
Publication Properties Dialog. However, a Subscription's update frequency is specified when the Subscription is created 
and cannot be changed. 


Field Description 


Run the process every: Select how frequently you want this Publication or Subscription to be automatically updated: 
Day, Week, or Month. 


on This list offers different selections depending upon the choice you made in the Run the process 
every field: 
a Day—Orly one selection is listed: Every Day. 
a Week-— Select the day of the week that you want to update this Publication or 
Subscription. 
a Month—Select the day of the month that you want to update this Publication or 
Subscription. 


At: Enter the time of day that you want the update to occur. 
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Field Description 


Starting on: Select the day or date that you want this Publication to begin being automatically updated on 
the day or date you selected from the Run the process every list. 


For example, if you want the Publication to be automatically updated on the 15th of each 
month, you would select the first day of the first month that you want the automatic updates to 
begin, not the first day that the Publication should be updated. If it is Monday and you want 
the Publication to be updated every Friday, to have the Publication begin being updated on 
the upcoming Friday, you would select the current day of the week (Monday), but if you didn't 
want the Publication to be updated until the Friday after next, you would select Saturday. 


Click OK to exit the Task Scheduling dialog. 
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Application Catalog Replication Wizards 


eo 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


Publication Wizard 


@ 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Publication Wizard for Application Catalog Replication walks you through the process of creating an SQL Server 
Publication from an Application Catalog database. 


Welcome Panel 


eo 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The first panel of the Publication Wizard welcomes you to the Wizard. 


Publication Wizard 
Welcome to the Publication Wizard 
p> The Publication wizard will walk through the options for 
creating a SQL Server publication from an ‘Application 
Catalog’. 


Click 'Next' to continue. 


This panel, and others in the Wizard, have four buttons located at the bottom of the Wizard. Depending on where 
you ate in the Wizard, certain buttons may be disabled. The buttons are: 
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Button Description 

Next Advances you to the next panel in the Wizard. 
Back Moves you to the previous panel in the Wizard. 
Cancel Terminates the Wizard. 

Help Brings up help about the specific Wizard panel. 


Click Next to continue to the Publication Details Panel. 


Publication Details Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


On the Publication Details Panel, you are prompted to enter basic Publication properties of name, description, and 
the schedule. 


Publication Wizard 


Publication Details 
Specify the properties of the publication. 


The publication requires certain specific properties in order to be created. Specify the requested 
properties and click 'Next' to continue. 


Description: 


Schedule: 
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The Publication Details Panel contains the following fields: 


Button Description 


Name Enter a name to identify this Publication. If you enter a duplicate name of an existing Publication, you 
will receive an error message. 


Warning: The Publication Name cannot be a T-SQL reserved word. 


Description Enter a description of the purpose or intended subscribers to this Publication. This description will be 
listed on the Publication Manager. 


Schedule In this field, you specify how often you would like this Publication to be automatically updated. When 
a Publication is updated, all of its data is replaced by replicated data from the Publisher's local 
Application Catalog database. 


This field is not directly editable. Click the Change button to access the Task Scheduling Dialog, 
where you can specify how frequently a Publication will be automatically updated. 


Click Next to continue to the Publication Data Options Panel. 


Publication Data Options Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Publication Data Options Panel prompts you to specify the particular types of data to include in the Publication. 


Publication Wizard 


Publication Data Options 
Specify the particular types of data to include in the publication. 


Select the types of data you wish to include in the publication and click 'Next' to continue. 


Publication Data Type Options 


[C] Merge Module Data 


All Merge Module data will be included in the publication. 
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The Publication Data Options Panel contains the following fields: 


Button Description 


Groups and Package Data Select this option if you want to select a specific set of packages from the various groups 
in the Application Catalog to include in the Publication. If you select this option, the 
Publication Packages Panel opens, prompting you to select packages to include in the 
Publication. If you do not select this option, all groups and all packages within those 
groups will be included in the Publication. 


Merge Module Data Select this option if you would also like to include all Merge Modules in the Application 
Catalog in the Publication. 


Click Next to continue to the Publication Access List Panel. 


Publication Access List Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


On the Publication Access List Panel, you specify the list of users allowed to access this Publication. It initially shows 
a list of users who have the necessary privileges to access the Publication: those users who have been assigned 
sysadmin privileges to this database server through the SQL Enterprise Manager. You can remove users from the list. 


Publication Wizard 


Publication Access List 
Specify the recipients of the publication. 


Specify the list of users allowed to access this publication and click 'Next' to continue. 
Users: 


Type Name N 
b Amber1 
a  ASAdmin 
È BUILTIN Administrators 
b distributor_admin 
b NansSGLSysadmin 
PM NarsSyetdmin 
2 sa 
b testlab 
8 TESTLABSGL\NansSysAdmin “i 


Cra Jones) (tones) (te) 
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The Publication Access List Panel contains the following fields: 


Field Description 

Type Displays an icon to identify each listing as either a user Bora group 2. 

Name Lists the name of the user or group. 

Remove Click to remove a user or group from the list. If a user is removed from the list, they will no longer be able to 
access the Publication, but they still would be able to be a user of the SQL Server and Publication database. 


Only users that have been assigned sysadmin privileges in SQL Enterprise Manager to the connected database server 
can establish the Publisher-Subscriber relationship between the databases and are therefore listed on this panel. You 
can remove a user from this list (so that they will not be able to access this Publication), but you cannot add additional 
users to this list using AdminStudio. To add new users, you must use SQL Enterprise Manager. 


Click Next to access the Publication Packages Panel (if you selected the Groups and Package Data option on the 
Publication Data Options Panel) or the Publication Summary Panel if you did not select that option. 


Publication Packages Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


On the Publication Packages Panel, the Groups and Packages in the Application Catalog you are connected to are 
listed. Select the packages that you want to include in this Publication. 


Publication Wizard 


Publication Packages 
Specify the packages destined for publication. 


Select packages for inclusion in the publication and click ‘Next’ to continue. 


CRM] Groups 
oH Orca v1.50.2600.0000 
OG PackageForTheWeb 4 v4.0.0 


Ccm e 
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You do not have to include all of the packages in the Application Catalog in this Publication. However, when this 
Publication is replicated in the Subscriber's Application Catalog, all of the Groups in the Publisher's Application 
Catalog will be listed, even if they do not contain any packages. 

When a user subscribes to this Publication, they are subscribing to all of the packages in all of the Groups that the 
Publisher has included. However, if the Publisher adds a new package fo one of these same Groups after he has 
created the Publication, the new package is not automatically added to the existing Publication, making it unavailable 


for Subscription. To publish this new package, a new Publication would have to be created or an existing Publication 
would have to be edited. 


This panel only appears if you selected the Groups and Package Data option on the Publication Data Options Panel. 


Click Next to continue to the Publication Summary Panel. 


Publication Summary Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


This panel provides a detailed summary of the options that were selected in the previous panels of the Wizard 


Publication Wizard 


Publication Summary 
Review your selected publication options. 


Click ‘Finish’ and a publication with the following options will be created. 


General Publication Information 
PackageForT he\Web5 
Latest release 
Once daily starting on: 1/5/2004 3:43:37 PM 


Data Types Selected 
Groups and Packages Data: 
Merge Module Data: 
Workflow Data: 


afm 


C:\Program Files\InstallS hield\AdminS tudi | Browse 


[C] Publish the publication immediately after creation 


eS a E 


The Publication Summary Panel contains the following options: 
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Property 


Description 


Generate publication as 
script 


To generate an SQL script of the code necessary to create this Publication rather than actually 
create it, select this option and enter a path name for the script file. For more information, see 
Replicating Application Catalogs in Controlled SQL Database Environments. 


Publish the publication 
immediately after 
creation 


To publish this Publication immediately after the Publication Wizard is finished, select this 
option. The name of this Publication would be listed on the Publication Manager with a status 
of Executing, and the Publication data would be replicated from your Application Catalog to 
the Publisher Database Server—making it available for Subscription immediately. 


If you do not select this option, you would have to click Run on the Publication Manager to 
publish this Publication manually, or the Publication would automatically be published on its 
scheduled date. 


Click Finish to complete the creation of this Publication. 
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Subscription Wizard 


|Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Subscription Wizard for Application Catalog Replication walks you through the process of creating an SQL 
Server Subscription to an Application Catalog database. 


Welcome Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The first panel of the Subscription Wizard welcomes you to the Wizard. 


Subscription Wizard 
Welcome to the Subscription Wizard 
Nae The Subscription wizard will walk through the options for 
creating a SQL Server subscription to an ‘Application 
Catalog’. 


Click 'Next' to continue. 


This panel, and others in the Wizard, have four buttons located at the bottom of the Wizard. Depending on where 
you are in the Wizard, certain buttons may be disabled. The buttons are: 


Button Description 

Next Advances you to the next panel in the Wizard. 
Back Moves you to the previous panel in the Wizard. 
Cancel Terminates the Wizard. 

Help Brings up help about the specific Wizard panel. 
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Click Next to continue to the Subscription Details Panel. 


Subscription Details Panel 


@o- 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


On the Subscription Details Panel, you are prompted to enter connection information for the Publisher database and 
scheduling information. 


Subscription Wizard 


Subscription Details 
Specify the specific options associated with the subscription. 


The subscription requires certain specific properties in order to be created. Specify the 
requested properties and click 'Next' to continue. 


Database: 


itestlabsql2k [H owePublisher2004) -sā | Change... 


Schedule: 
| Once daily starting on: 1/5/2004 4:29:25 PM 


ee (Hop) 


The Subscription Details Panel contains the following fields: 


Button Description 


Database Click the Change button and browse to the Publisher database that you are subscribing to. The SQL Server / 
MSDE Login Dialog appears, a standard SQL Server database browse dialog. 


Note: You must connect to a SQL Server database that was identified as being intended for use as a Publisher 
when it was created. See Create / Connect to Application Catalog Dialog. 


Schedule In this field, you specify how often you would like this Subscription to be automatically updated. When a 
Subscription is updated, all of its data is replaced by replicated data from the Publisher database. 


This field is not directly editable. Click the Change button to access the Task Scheduling Dialog, where you 
can specify how frequently the Subscription will be automatically updated. 


Click Next to continue to the Subscription Selection Panel. 
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Subscription Selection Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The Subscription Selection Panel displays the Publications available from the selected Publisher database that satisfy 
the Publication Access List requirements for the currently connected user. In other words, it lists the Publications that 
this user has permission to subscribe to. 


Subscription Wizard 


Subscription Selection 
Selection the publication to subscribe. 


Select one publication to subscribe to and click ‘Next! to continue. 


Available Publications for 'testlabsql2k (HowePublisher2004) - sa’: 


Name Description 

Orca Orca testing application 
PackageForThe\Web Internet application 
PackageForTheWeb5 Latest release 

Orca 6 Latest release 
PackageForTheWweb 6 Latest release 


EEEE Coca} (ie) 


Select one Publication from this list to subscribe to and click Next to continue to the Summary Panel. 
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Subscription Summary Panel 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


This panel provides a detailed summary of the options that were selected in the previous panels of the Wizard. 


Subscription Wizard 


Subscription Summary 
Review your selected subscription options. 


Click ‘Finish’ and a subscription with the following options will be created. 


Subscription Details 

Publisher: testlabsql2k 
Publisher Database: HowePublisher2004 
Publication: PackageForT he\Web 
Publication Description: Internet application 


Subscription Datatabase 

Database Server: testlabsql2k 
Database Name: HoweSubscriber2004 
Database User: sa 


> 


Browse 


(cee Jen] [cava] (ep) 


To generate an SQL script of the code necessary to create this Subscription rather than actually create it, select the 
Generate subscription as script option and enter a path name for the script file. For more information, see Replicating 
Application Catalogs in Controlled SQL Database Environments. 


Click Finish to complete the creation of this Subscription. 
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Replication Command Line Options 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


These options are provided in case you would like to run Application Catalog Replication using the command line. 
However, this functionality can be invoked from the main AdminStudio interface. 


The following Application Catalog Replication command-line options are supported by AdminStudio: 


Option Description 


-c"Connection String" Optional, if not present we attempt to connect to the default database. Otherwise, we will 
prompt the user for a connection of an existing database. 


-q Silent launch without splash dialog. 


-h[number] Parent window handle. (Optional) 
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Replication Tables 
oN 
@- 
Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


When a Publication is published, not all of the tables from the original Application Catalog database are replicated on 
the Publisher Database Server. This section lists the included and excluded tables: 


Tables Excluded From Replication 


if ~N 
@— 
Ss Ag 
Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


The following tables are excluded from Application Catalog Replication: 


Description Table Names 


Pre-Existing Conflict Data cestblConflictConfiguration 
cstblConflictACE 
cstblConflictPackages 
cstblConflictResults 
cstblConflictTransformList 
cstblConflictResultsDestPkgs 


Database Security Tables assysRolePermissions 
assysRoles 
assysRoleTools 
assysUserRoles 


Custom Tables All custom tables are excluded. 
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Description Table Names 

Miscellaneous asAMSAppRegistrations 
asAMSWorkflowProjects 
cstblSubscribedDatabases 
cstblSubscribedData 


cstblPackageRelationships 
cstbllgnoreTableList 
cstblPackageHistoryLog 
cssysExtendedAtiributeSchema 
cssysSchemalnfo 
cssysTables 
csmsisys_Validation 
csmsisys__ Tables 
csmsisys__Columns tables 
witb|CommandLines 
witbITemplateTasks 
whtbITemplateWorkflow 
witblTemplates 

wftblTools 
wftblUserWorkflows 
wftblWorkflowTasks 
wftblGroups 
wftblGroupTools 


Tables Included in Replication 


Application Catalog Replication is a snap-in feature available only with InstallShield AMS 2.0. 


One or both of the following sets tables are included in Application Catalog Replication, depending upon the 
selections made on the Publication Data Options Panel of the Publication Wizard: Groups and Package Data or 


Merge Module Data. 


Description 


Table Names 


General Package and 
Group Data 


cstblPackage 

cstblGroups 
cstblGroupPackages 
cstblExtendedAttributeData 
cstblTransformFile 
cstblPatchFiles 

cstblSetupFiles 

All of the various "csosc" tables 
All of the various "csmsi" tables 


Merge Module Tables 


All of the various "csmsm" tables 
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This is a snap-in feature available only with InstallShield AMS 2.0. 


AdminStudio implements security and access based on defined users, roles, and permissions. Administrators define 
the users that can have access to the AdminStudio Application Catalog, as well as the role they play in the 
organization. For example, a user might be assigned a role of repackaging, necessitating permissions to execute 
AdminStudio projects and related tools. However, that user may not have access to ConflictSolver and its 
functionality. By defining roles for similar users, administrators can restrict access to pieces of AdminStudio and the 
Application Migration process, thereby creating a more streamlined business process. 


AdminStudio security is only supported for SQL Server—based Application Catalogs, and is only included with 
InstallShield AMS 2.0. Only users with administrative rights in AdminStudio can access AdminStudio security. 
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Authentication and Authorization 


o- 
vw 
This is a snap-in feature available only with InstallShield AMS 2.0. 


At the core of AdminStudio security are the concepts of authentication and authorization. Before taking advantage of 
AdminStudio's security features, consider overviews of these concepts. 


Authentication 


In the context of AdminStudio, authentication involves ensuring a user is supposed to have access to AdminStudio. 
This is accomplished in AdminStudio via either SQL Server login information, or via NT permissions. When the 
AdminStudio Application Catalog has been configured by the AdminStudio Administrator, only usets who have been 
defined as valid AdminStudio users will have access to the Application Catalog (via AdminStudio). 


Authorization 


Once AdminStudio has authenticated you as a valid AdminStudio user, you can be authorized to perform specific 
tasks in AdminStudio. Depending on the role assigned to you, you may be able to access certain tools, or certain 
functionality within tools. Each role has associated permissions governing what you can and cannot do in 
AdminStudio. Because the AdminStudio Administrator creates roles, defines permissions for roles, and assigns roles 
to users, your authorization is customized for your individual needs. 
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AdminStudio Administrators 


TN 
@- 


This is a snap-in feature available only with InstallShield AMS 2.0. 


There are two ways AdminStudio identifies administrators: 


Method 


Explanation 


Members of the SQL Server sysadmin 
role for the SQL server where the 
AdminStudio Application Catalog 
resides 


As a SQL Server sysadmin, even if you have not explicitly been added 
as a user in AdminStudio, you can log in to AdminStudio and have full 
control over the AdminStudio Application Catalog. 


Users assigned the Administrator role 
in AdminStudio 


Once you have been assigned the Administrator role in AdminStudio, 
you receive the SQL Server roles of securityAdmin, dbcreators, and 
db_owners. This allows you to create new Application Catalogs, add 
users, and make changes. 


If you are the SQL Server sysadmin, you can create SQL Server—based Application Catalogs right away in 
AdminStudio. However, if you are not, the SQL Server sysadmin will have to run the SQL Server scripts to create the 
Application Catalog. The scripts automatically create a default user, ASAdmin, who is assigned the Administrator role 


in AdminStudio. The default password for ASAdmin is ASAdmin. A user who is going to serve as AdminStudio 


Administrator should log into the new Application Catalog as ASAdmin, create a new user account with the 


Administrator role, and then log out. The new administrator can then log in under the new user account and delete 


the ASAdmin account to prevent unauthorized access to the Application Catalog. 
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© 


This is a snap-in feature available only with InstallShield AMS 2.0. 


Fach user in AdminStudio can be assigned a role. These roles are defined by the AdminStudio Administrator, who is 
the person who created the Application Catalog. Others can have administrative rights, but only the Application 
Catalog creator is the AdminStudio Administrator. 


AdminStudio ships with two default roles: Administrator and Author. The Administrator role has full permissions in 
AdminStudio. The Author role lacks the Change Workflow Product Settings, Change Default Database, and Merge 
Database permissions. 


New roles are created based on existing roles. You simply pick an existing role, and the permissions for that role are 
copied to the new role. You can then modify the permissions accordingly. Role management is done in the Manage 
Roles dialog. 


Although you can base a new role off of the Administrator role, the new role does not inherit the ability to access 
AdminStudio security. For example, if you create the new role Administrator2 based on the Administrator role, and do 
not change any permissions for Administrator2, then users in the Administrator2 role will be able to do everything users 
in the Administrator role can except access AdminStudio security. 
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Creating New Roles 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To create a new role for users in the AdminStudio Application Catalog: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
b ASAdmin ASAdmin Administrator 
b dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 
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3. In the Manage Users dialog, click Manage Roles. The Manage Roles Dialog opens. 


Manage Roles 


Roles: i 
Role 
R Administrator 


T 


Delete 


Permissions for ‘Author’: 


Permissions Type 
Edit Workflow Properties Workflow 
Delete Workflow Workflow 
Create Workflow Workflow 
View Workflow Tab Workflow 
Edit Project Properties Workflow 
Delete Project Workflow 
Create Project Workflow 
Launch Tool Workflow 
Edit Tool Properties Workflow 
Delete Tool Workflow vi 


K) K K K K K K K KKI 


4. |n the Manage Roles dialog, click New. The New Role Dialog opens. 


Role name: 


Based on: 


Administrator v| 


5. In the New Role dialog, enter the Role name for the new role, and select the starting permissions Based 
on an existing role 


6. Click OK to dismiss the New Role dialog. 
7. Select the new role from the Roles list and select the appropriate permissions from the Permissions list. 


8. Click OK to close the Manage Roles dialog. The role is now available for assignment to a user. 
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Assigning Permissions to Roles 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To assign a permission to a role: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
b ASAdmin ASAdmin Administrator 
3% dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 


InstallShield Software Corporation © 2004 195 


AdminStudio 5.5 User Guide 


3. In the Manage Users dialog, click Manage Roles. The Manage Roles Dialog opens. 


Manage Roles 
Roles: 
Role 
R Administrator 


FA 


Permissions For ‘Author's 


Permissions 

Edit Workflow Properties 
Delete Workflow 
Create Workflow 

View Workflow Tab 
Edit Project Properties 
Delete Project 

Create Project 
Launch Tool 

Edit Tool Properties 
Delete Tool 


K) K K K K K K KKK 


Type 
workflow 
workflow 
workflow 
workflow 
workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 


v 


4. In the Manage Roles dialog, select the Role for which you want edit permissions. 


5 AdminStudio Security 


5. Modify the permissions for the role by selecting or clearing the check boxes next to individual 
permissions in the Permissions list. 
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Assigning Roles to Users 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To assign a role to a user: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
F5 ASAdmin ASAdmin Administrator 
RB dbo sa Administrator 


Roe: | EI ~ 
Add NT User... New SQL User... Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 


3. In the Manage Users dialog, select the user to which you want to assign a role from the Users list. 
4. From the Role list, select a role for the selected user. 


5. Click OK to close the dialog. 
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Removing Roles 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To remove a role from the AdminStudio Application Catalog: 


1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name 
Ê ASAdmin ASAdmin 


LEZ 


Role 
Administrator 
Administrator 


Role: Administrator 


Add NT User... New SQL User... 


Permissions For ‘Administrator’: 


Remove Manage Roles... 


Permissions Type 
8 Full Control AdminStudio 
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3. In the Manage Users dialog, click Manage Roles. The Manage Roles Dialog opens. 


Manage Roles 


Roles: 


Role 
R Administrator 


| 
| 
| 
| 
| 
| 
| 
| 


BN auar 


Permissions For ‘Author's 


Permissions 

Edit Workflow Properties 
Delete Workflow 
Create Workflow 

View Workflow Tab 
Edit Project Properties 
Delete Project 

Create Project 
Launch Tool 

Edit Tool Properties 
Delete Tool 


f 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


KI [S] [K] K] K] K] K] AK K 


Type 
workflow 
workflow 
workflow 
workflow 
workflow 
Workflow 
workflow 
workflow 
workflow 
workflow 


Mi 


4. In the Manage Roles dialog, select the Role you want to remove and click Delete. 


5. Confirm the deletion. 
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Viewing Role Assignments 


This is a snap-in feature available only with InstallShield AMS 2.0. 


JE 


To view users who have a particular role assigned to them: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
b ASAdmin ASAdmin Administrator 


% dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 


InstallShield Software Corporation © 2004 


5 AdminStudio Security 


200 


AdminStudio 5.5 User Guide 


3. In the Manage Users dialog, click Manage Roles. The Manage Roles Dialog opens. 


Manage Roles 


Roles: 


| Role 
| R Administrator 


T 


Permissions For ‘Author's 


Permissions 

Edit Workflow Properties 
Delete Workflow 
Create Workflow 

View Workflow Tab 
Edit Project Properties 
Delete Project 

Create Project 
Launch Tool 

Edit Tool Properties 
Delete Tool 


f 
| 
| 
| 
| 
| 
| 
| 


SSN KKM MM K] 


Type 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 
Workflow 


5 AdminStudio Security 


4. In the Manage Roles dialog, select the Role for which you want to view membership information and 
click Members. The Role Members Dialog appears, listing all of the members assigned to the selected 


Role. 


Role Members 


Members: 


Name 
D  asadmin 


ĝ sa 


5. Click OK to close the dialog. 
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This is a snap-in feature available only with InstallShield AMS 2.0. 


Users in AdminStudio can either be defined as SQL Server users or NT users. NT users are added from existing NT 
domains. NT groups can also be added, including all users in the group. SQL Server users are added from 
AdminStudio's Manage Users Dialog. 


Each user is assigned a role, and that role determines the permissions they have in AdminStudio. 


InstallShield Software Corporation © 2004 202 


AdminStudio 5.5 User Guide 5 AdminStudio Security 


Adding NT Users and Groups 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To add NT users or groups for access to the AdminStudio Application Catalog: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name LoginName Role 
b ASAdmin ASAdmin Administrator 
b dbo sā Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 
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3. In the Manage Users dialog, click Add NT User. The Add User Dialog appears. 


Add User 


Domain: 


INSTALLSHIELD 


Users and groups: 


Name 

Accounting 
Accounting Manage 
AccountsUK 
AdminStudio 

Cert Publishers 
Consulting 
ConsultingInst-1 
ConsultingInstallShi 


Comment 
Account Department 


Global Group For Accounting M... 


Enterprise certification and re... 
15 Consulting Department 


v 


Members 


5 AdminStudio Security 


4. In the Add User dialog, select the user or group you want to add and click OK. The user now appears 
in the Users list in the Manage Users dialog. 
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Creating New SQL Users 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To create a new SQL user in the AdminStudio Application Catalog: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


b ASAdmin ASAdmin Administrator 


% dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 
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3. In the Manage Users dialog, click New SQL User. The New User Dialog appears. 


SOL Server login: 


Password: 


4. In the New User dialog, assign an SQL Server login and Password for the SQL user. 


5. Click OK to close the New User dialog. The new SQL user is added to the User list. You can then 
assign a role to the new user. 
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Removing Users 


This is a snap-in feature available only with InstallShield AMS 2.0. 


a. 


To revoke a user's (SQL or NT) access to the AdminStudio Application Catalog: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
F5 ASAdmin ASAdmin Administrator 
BR dbo sa Administrator 


Role: acmnstratr ~ 
Add NT User... New SQL User... Manage Roles... 


Permissions for ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 


3. In the Manage Users dialog, select the user you want to delete from the Users list and click Remove. 


4. Confirm the deletion. 
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Viewing NT Group Membership 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To view members of an NT Group: 
1. Launch the AdminStudio Interface. 


2. From the Catalog menu, select Security. The Manage Users Dialog opens. 


Manage Users 


Users: 


Name Login Name Role 
b ASAdmin ASAdmin Administrator 
3% dbo sa Administrator 


Role: Administrator 


Add NT User... New SQL User... Remove Manage Roles... 


Permissions For ‘Administrator’: 


Permissions Type 
8 Full Control AdminStudio 
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3. In the Manage Users dialog, click Add NT User. The Add User Dialog appears. 


Add User 


Domain: 
INSTALLSHIELD 


Users and groups: 


Name Comment 

Accounting Account Department 

Accounting Manage Global Group for Accounting M... 
AccountsUK 

AdminStudio 

Cert Publishers Enterprise certification and re... 
Consulting 15 Consulting Department 
ConsultingInst-1 

ConsultinalnstallShi 


4. In the Add User dialog, select the group for which you want to view membership and click Members. 
The Group Members Dialog appears, listing all the members of the selected group. 


Group Members 


Members of 'INSTALLSHIELD\AccountsUK' Group: 
Name 


DenahStevens 
AndrewStubbs 
JennyRideout 
StuartHarris 
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Viewing Permissions for the Current User 


This is a snap-in feature available only with InstallShield AMS 2.0. 


To view the roles and permissions associated with the currently logged-in user: 
1. Launch either the AdminStudio Interface or ConflictSolver. 


2. From the Catalog menu, select User Properties to display the User Properties Dialog, where your 
currently assigned Roles and Permissions are listed. 


User Properties 


8 User name: sa 
Server: testlabsqlZk 
Database: HoweCatalog2004 
Database Type: Publisher Database 


Roles: Permissions: 
| Administrator Full Control 


3. When finished viewing permissions for the current user, click OK to close the dialog. 
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This is a snap-in feature available only with InstallShield AMS 2.0. 


AdminStudio supports several permissions which can be assigned to different roles. 


Workflow Permissions 


Permission 


Explanation 


View Workflows Tab 


Can view the Workflows tab in the AdminStudio Interface 


Create Workflow 


Can create new workflows 


Delete Workflow 


Can delete existing workflows 


Edit Workflow Properties 


Can edit properties for workflows 


Create Project 


Can create new projects 


Delete Project 


Can delete existing projects 


Edit Project Properties 


Can edit project properties 


Add Tool 


Can add tools to the Tools Gallery 


Delete Tool 


Can delete tools from the Tools Gallery 


Edit Tool Properties 


Can edit properties for tools in the Tools Gallery 


Launch Tool 


Can launch a tool in the Tools Gallery; can run tools specified in workflows and projects 


Change Default Database 


Can change the default AdminStudio Application Catalog 


Edit Product Settings 


Can change settings in the AdminStudio Options dialog 
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ConflictSolver Permissions 


Permission Explanation 


Import Applications Can import packages or merge modules into ConflictSolver, including re-importing 
packages resulting from unlinked data or conflict resolution 


Delete All Can purge all ConflictSolver data from the Application Catalog 

Delete Can delete individual packages from the Application Catalog 

Run Conflicts Can use the Conflict Wizard to identify conflicts 

Run Rules Wizard Can run the Rules Wizard to import user-defined ACE rules 

Resolve Conflicts Can resolve detected conflicts 

Merge Database Can merge ConflictSolver information in two Application Catalogs 

Change Data Can write to the Application Catalog for ConflictSolver (without this permission, any 


ConflictSolver permission that allows users to write to the Application Catalog will not 
function; ConflictSolver is essentially read-only for roles without this permission) 


Change Extended Attributes Can change the XML file used to configure the extended attribute definition 


Change Database Can open another Application Catalog 
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Tool Permissions 


When additional tools are added into the Tools Gallery, permissions are dynamically added. 


Permission Explanation 

DevStudio DevStudio appears in the Tools Gallery and can be launched 
ConflictSolver ConflictSolver appears in the Tools Gallery and can be launched 
Tuner Tuner appears in the Tools Gallery and can be launched 


Repackaging Wizard The Repackaging Wizard appears in the Tools Gallery and can be launched 


OS Snapshot The OS Snapshot Wizard appears in the Tools Gallery and can be launched 

Application Isolation The Application Isolation Wizard appears in the Tools Gallery and can be launched 

Wizard 

Global Exclusions The Global Exclusions Editor appears in the Tools Gallery and can be launched 

Editor 

Distribution Wizard The Distribution Wizard appears in the Tools Gallery and can be launched 

Package Converter Repackager appears in the Tools Gallery and can be launched 

Application The InstallShield AMS 2.0 icon appears in the Tools Gallery and can be launched. When you 

Management System have permission to launch AMS from the AdminStudio Interface, you will automatically be 
logged in. 


This is a snap-in feature available only with InstallShield AMS 2.0. 
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Introduction 


Installations created for the Windows Installer service dramatically differ from traditional setups, making reusing 
legacy setups impossible without using a repackaging tool. Repackager assists you by capturing the data placed on 
your system during installation and converting it into a Windows Installer (MSI) package, which you can then 
customize and distribute according to your organization's needs. 


The Repackaging method you use depends upon the source type you are using: 


= Application Media—Repackage these legacy setups using the Repackaging Wizard. 
See Repackaging a Legacy Setup. 


O For InstallShield Professional 5.5 to 7.x setups, you would then gather additional information using 
the InstallShield SmartScan Wizard. 


O For InstallShield DevStudio 9.x InstallScript setups, additional information is automatically gathered 
by using the InstallShield Professional Logging Method. 


= Setup Project—Convert these legacy setups using Open on the File menu on the Repackager Interface. 
See Converting a Legacy Setup. 
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Repackaging Options Comparison Chart 


The following table details the different options available to you when using Repackager, based upon source type, 


product and version: 


Source Product/Version Repackaging Method Result 
Media IS Professional 1.x to 5.1.x Repackaging Wizard (using Repackager project with no 
Fa either Installation Monitoring or feature delineation 
T g 
( ei y Snapshot method) 
IS Professional 5.5 to 7.x Repackaging Wizard (using Repackager project with feature 
either Installation Monitoring or delineation, including registry 
Snapshot method) and SmartScan entries and shortcuts 
Wizard 
IS DevStudio 9.x InstallScript Repackaging Wizard using the Repackager project with feature 
InstallShield Professional Logging delineation, including registry 
Method entries and shortcuts. Also 
captures path variables and 
converts them into properties 
(using text substitution rather 
than hard-coded path names). 
Project = Repackager 3.x output (.inc) Select Open on the File menu on Repackager project with no 
= Microsoft SMS projects (.ipf) the Repackager Interface, to have feature delineation 
= Novell ZENworks projects (. Repackager automatically convert 
axt) (3.0 and earlier) file to a Repackager project. 
= WinINSTALL projects (.txt) 
(6.0, 6.5, and 7.x} 
a Wise installation projects (.wse) 
=a InstallShield Pro log files (isl) | Select Open on the File menu on Repackager project with feature 
the Repackager Interface, to have delineation 
Repackager automatically convert 
file to a Repackager project. 


Once you have created a Repackager project, you can visually examine the files, INI files, shortcuts, and registry data 
from the setup, and exclude any non-essential items. Then, you can build the Repackager project into an InstallShield 
DevStudio project (ism) for further editing, or create a Windows Installer package (.msi). 


Benefits of Repackaging a Setup 


Repackaging a setup into a Windows Installer package provides the following benefits: 


m You can further configure it using DevStudio. 


m You can use Tuner to create transforms from it, providing extensive customization for your specific needs. 
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m You can check the package for conflicts that may exist between it and other known Windows Installer packages in 
the ConflictSolver Database, ensuring the proper installation and functioning of your setups. 


m Finally, once converted to a Windows Installer package, the setup can take advantage of Windows Installer 
functionality such as application repair and feature advertisement. 


Repackager Best Practices 


When using Repackager, please implement the following Best Practices: 


Best Practice Explanation 

Capture everything using the In previous versions of AdminStudio, it was beneficial to create a detailed exclusion 
Repackaging Wizard and list to restrict the Repackaging Wizard (then known as Repackager) and speed up 
exclude using the Repackager repackaging. The recommended model starting with AdminStudio 5 is to 
Interface repackage using the InstallShield provided exclusions and then use the Repackager 


Interface to visually remove unwanted items from the capture. Because this occurs 
post-capture, you do not need to recapture the legacy setup if you inadvertently 
exclude items from the Windows Installer package you are building. 


Since Windows Installer does not support packaging device drivers, you would 
need to create Custom Actions to install device drivers. See Using Custom Actions 
in the Windows Installer help section for more information. 


Repackage on a clean system It is essential that you repackage applications on a "clean" system to ensure you 
capture all changes made by the installation. 


Exit all other applications Other applications may lock files or directories, and may hinder the performance of 
the setup and repackaging. 


Run Repackager over the Repackager is configured to ignore its own files and output by default, which is 

network sufficient in most cases. However, if you want to ensure your machine is completely 
clean, run Repackager remotely over the network and store output files to a network 
drive. 


For example, if you are repackaging on a clean system and have AdminStudio 
installed on a production machine, map the production machine to a drive on the 
clean system. You can then run Repackager from the production machine. When 
picking an output directory, store the output back onto the production machine 
instead of on the clean machine. This process ensures you do not inadvertently 
capture Repackager files during repackaging. This functionality works whether you 
use a physical computer as a clean system or a program such as VMware to create 
a virtual clean system. 
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Best Practice Explanation 


Only repackage non-MSI-based Windows Installer setups should not be repackaged. They should either be edited in 
setups DevStudio, or, as Microsoft recommends, by creating a transform. This can be done 
using Tuner. 


You should not repackage MSI packages for the following reasons: 


= Repackaging a MSI package is against Microsoft Best Practices. 

a If you make changes to an MSI package, vendors will no longer provide 
support for that product. 

= |f you repackage an MSI package, the component codes within the MSI 
package are not retained and hence future patching or upgrades will not work. 

= Traditionally, repackaging tools will ignore the MSI specific data in the registry. 
This will result in an incomplete package. 


Clean Systems 


For optimal results when using Repackager or OS Snapshot, you should perform these processes on a clean system. A 
clean system typically consists of a computer with only the operating system and necessary service packs installed on 
it. It is the baseline system that the computer requires to run. 


Although it may be tempting to consider basic software, such as Microsoft Office, as part of the clean system, this can 
result in poor snapshots and repackaged setups. Each application you install on the baseline system adds to the DLLs, 
changes versions of files, makes new registry entries, etc. This may cause Repackager or the OS Snapshot Wizard to 
miss these during capture, which ultimately may lead to missing files or registry entries in repackaged setups, or 
unexpected conflicts between the operating system and Windows Installer packages. 


( jw }— 
\ J 
To download a standalone, zero-footprint setup for Repackager, go to the following URL: 


http://support.installshield.com/kb/files/Q108601/setup.exe 


You can copy this to a clean system and install it to run Repackager standalone, instead of with the entire AdminStudio 
suite. When installation is complete, the Repackager executable will be located in the following directory: 


\Program Files\InstallShield\Repackager\islc.exe 


Alternate-Language Repackaging on Clean 
Machines 


The standalone Repackager setup for clean machines does not install any language resources other than US English. 
Therefore, if you are Repackaging a setup on a clean system in a language other than in US English, you need to 
ensure you point to the correct template in the Repackaged Output view. This can be on a mapped network drive, or 
you can copy the language-populated template (for example, ISProjBlankTpl.ism) to your clean system from the 
<AdminStudio Directory>\DevStudio\Support directory. Language-specific templates are available when you 
purchase InstallShield DevStudio Language Packs. 
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Repackaging Methods 


Repackager supports three methods of repackaging: Snapshot, Installation Monitoring, and InstallShield Professional 
Logging Method. 


The snapshot method involves taking a reference snapshot of a system as a baseline configuration, performing the 
installation, and then taking a second snapshot. The difference between the two snapshots is stored in a directory you 
specify, along with the Repackager output file (inc). This file can then be converted into a Windows Installer package 
(.msi) using the Legacy Setup Conversion Wizard. 


When repackaging using snapshot technology, you should use a clean system, with a baseline configuration for your 
target environment. If you do not repackage on a clean system, you may not capture all of the necessary files for the 
setup because the files may already be installed on the system. 


Although slower than Installation Monitoring, the snapshot method works on Windows 9x, NT 4, Me, 2000, and XP 
operating systems. 


Installation monitoring involves "watching" a system for any processes that are created during an installation, By 
monitoring these processes in the background, the Repackager can identify files, shell links, and registry entries that 
are added, modified, or removed by the installation. The resulting files and Repackager output file can be converted 
into a Windows Installer package. 


Installation Monitoring is significantly faster than the snapshot repackaging method, but only works on Windows XP, 
2000, and NT 4 systems. 


Although it is still a good practice to repackage on a clean system, it is not as important when using installation 
monitoring technology. 


InstallShield Professional Logging Method 


Using the InstallShield Professional Logging Method, Repackager can read logged output of InstallShield DevStudio 
9.x InstallScript setups. This method replaces the other repackaging methods (Installation Monitoring and Snapshot) 
for DevStudio 9.x InstallScript setups. For more information, see InstallShield Professional Logging Method. 


(= 
á) — 
NA 
The InstallShield Professional Logging Method is not offered as a choice on the Method Selection Panel of the 
Repackaging Wizard. If you specify an InstallShield DevStudio 9.x InstallScript setup on the Collect Product Information 
Panel, Repackager will automatically detect the DevStudio 9.x InstallScript setup and will display the InstallShield 


Professional Setup Panel, where you can choose to use InstallShield Professional Logging Method instead of the 
repackage method you chose on the Method Selection Panel. 
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InstallShield Professional Logging Method 


\\i 


The InstallShield Professional Logging Method is supported for InstallShield DevStudio InstallScript 9.x and higher 
setups. 


Using the InstallShield Professional Logging Method, Repackager can read logged output of InstallShield DevStudio 
9.x InstallScript setups. This method replaces the other repackaging methods (Installation Monitoring and Snapshot) 
for DevStudio 9.x InstallScript setups. By using this method, you will be able to get additional information from the 
Professional setup that would not be captured by repackaging: 


mE Path Variables—Path variables are captured and converted into properties (using text substitution rather than 
hard-coded path names). For example, if you were using a standard repackaging method, the path name of the 
application's executable file would be captured as follows: 


c:\Program Files\CompanyName\App1icationName\ProgramName.exe 


When using the Professional Logging Method, the executable path name would be captured using a path variable instead of a 
hard-coded path name: 


[INSTALLDIR]\ProgramName. exe 


= Feature Tree—The InstallShield Professional Logging Method is able to group files, shortcuts and registry 
entries into features corresponding to InstallShield Professional components. Any items (files, folders, shortcuts, 
ot registry entries) that are attached to a component directly or indirectly (through File Groups), are attached to 
corresponding features. 


=| Features 


@) DemoPlayerApp 
©) InstallShieldProDema 
@) DemoShieldDemo 


For instructions on how to use the InstallShield Professional Logging Method when repackaging InstallShield 
DevStudio 9.x InstallScript setups, see Using the Repackaging Wizard and InstallShield Professional Setup Panel. 
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Launching Repackager 


Repackager can be launched from within the AdminStudio Interface. Additionally, if you install Repackager on a 
network, use Windows Explorer to browse to the islc.exe executable on the shared drive. 


To launch Repackager from the AdminStudio Interface: 
1. Launch AdminStudio. 


2. From the Tools Gallery, click the Repackager icon on the left side. 


Repackager 


The Welcome to InstallShield Repackager Page opens and you can immediately begin the repackaging 
process. 


Creating Repackager Projects 


Repackager projects (.irp) allow you to visually analyze the files, INI files, shortcuts, and registry entries captured or 
changed during the conversion of a legacy setup into a Windows Installer package. You can also exclude files, 
shortcuts, registry entries, and INI files from the resulting Windows Installer package, without affecting the original 
setup data. 


There are two methods of creating Repackager projects: 
E Repackaging a Legacy Setup using the Repackaging Wizard. 


E Converting a Legacy Setup Project (Repackager 3.x output, Microsoft SMS projects, Novell ZENworks projects 
(3.0 and earlier), WinINSTALL files, Wise installation projects, or InstallShield Professional log files). 


Repackaging a Legacy Setup 


One frequently used method of creating a Repackager project is to repackage a legacy setup. Fundamentally, this 
involves monitoring the execution of a non-Windows Installer setup and converting changes made by the setup into a 
Windows Installer file. 


Repackager provides the Repackaging Wizard for accomplishing this task. Using this Wizard, you can select the 
repackaging method (either snapshot or installation monitoring), specify the setup(s) you want to repackage, and run 
the setup(s). When the Repackaging Wizard has finished its analysis, Repackager automatically creates a Repackager 
project (.irp) file, which can be modified in Repackager. You can then convert this file to an InstallShield DevStudio 
project (ism) for further editing, or convert it directly to a Windows Installer package (msi). 
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For InstallShield DevStudio 9.x InstallScript setups, you can choose to use the InstallShield Professional Logging Method 
instead of the snapshot or installation monitoring methods. 


Using the Repackaging Wizard 


a 
To repackage a legacy setup using the Repackaging Wizard 


1. Launch the Repackaging Wizard from Repackager. The Welcome Panel opens. 
InstallShield Repackaging Wizard 
Welcome to InstallShield Repackaging Wizard 


This wizard enables you to create a completely new 
installation For an existing, packaged application, It can 
also create an installation project that can be further 
enhanced using InstallShield DevStudio, 


© \ For optimal use, InstallShield Repackaging Wizard 
DD should be run remotely from a mapped location. 
See the Help Library topic "Repackaging Wizard 
Best Practices" for details. 
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2. From the Welcome Panel, click Next. The Method Selection Panel opens. 


InstallShield Repackaging Wizard 


Method Selection 
Select 4 repackaging method. 


system by the setup program(s). It then analyzes these activities and stores the setup 
data in an output file which can be converted into a Windows Installer package. 


O Snapshot 


Repackaging Wizard takes an initial snapshot of the local system, runs the setup 
program(s}, and then takes a second snapshot. The difference between the two 
snapshots is stored in an output file which can be converted into a Windows Installer 
package. 


3. From the Method Selection Panel, select a repackaging method: Installation Monitoring or Snapshot. 


The InstallShield Professional Logging Method, which should be used to repackage InstallShield DevStudio 9.x 
InstallScript setups, is not offered as a choice on the Method Selection panel. However, if you specify a 
DevStudio 9.x InstallScript setup on the Collect Product Information Panel (the next panel in the Repackaging 
Wizard), Repackager will automatically detect the DevStudio 9.x InstallScript setup and will display the 
InstallShield Professional Setup Panel, where you can choose to use the InstallShield Professional Logging 
Method instead of the Installation Monitoring or Snapshot methods. It does not matter which method you select 
on the Method Selection Panel, but if you select the Snapshot method and then select Multiple Steps on the 
Snapshot Method Panel (which appears next), Repackager will not recognize the setup as a DevStudio 9.x 
InstallScript setup and the InstallShield Professional Setup Panel will not appear. 
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4. On the Method Selection Panel, click Next. If you selected Snapshot on the Method Selection Panel, the 
Snapshot Method Panel appears. (If you selected Installation Monitoring, skip to Step 6.) 


InstallShield Repackaging Wizard 


Snapshot Method 
Select either a single-step or multiple-step snapshot method, 


In a single pass, automatically analyze the initial system status first, run one or 
more setup programs (to modify the local system), and then analyze the 
system status changes. 


Prompt before running the setup program(s) 


© Multiple Steps (Classic Style} 
Analyze the initial system status 


Analyze system status changes 


InstallShield Repackaging Wizard 


Collect Product Information 
Provide product information for repackaging, Items with asterisks (*) are 
required. 


Setup Programs 


*Program File: 


Command-line 
Argument(s); 


Edit Setup List 


Product Information 


*Product Name: | PackageForTheWeb 4 | Version: | 4.0.0 


Product URL: http://www. installshield, | Support URL: | http://www. installshield, 


Company Name: | InstallShield Software Corporation 


If Multiple Steps was selected and you are performing the initial snapshot, the Collect Product Information 
panel is displayed, but the Setup Programs area is disabled. 
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6. On the Collect Product Information Panel, enter product information and click Next. For instructions on 
adding additional setup programs, see Adding Additional Setup Programs. 


@— 


a 


If you are repackaging an InstallShield DevStudio 9.x InstallScript setup and want to use the InstallShield 
Professional Logging Method, do not specify more than one setup program. If you do, Repackager will not 
recognize the setup as a DevStudio 9.x InstallScript setup and the InstallShield Professional Setup Panel will 
not appear. 


7. When you click Next on the Collect Product Information Panel, one of the following panels appears: 


a. If you are performing a system status change analysis, the Repackaging Panel appears, displaying 
the progress of the repackaging operation. Skip to Step 10. 


b. If you specified an InstallShield DevStudio 9.x InstallScript setup in the Program File field of the 
Collect Product Information Panel, the InstallShield Professional Setup Panel appears. Specify if you 
want to use the InstallShield Professional Logging Method, and click Next to continue to the Set 
Target Project Information and Capture Settings Panel. 


InstallShield Repackaging Wizard 


InstallShield Professional Setup 
Optionally change repackaging method for ISPro setup 


The setup you are launching was created with InstallShield Professional. The AdminStudio 
Repackager can directly read logged output of InstallShield Professional Engine operations, 
removing the need for repackaging InstallShield Professional setups. 


It is recommended that you use this method instead of repackaging. 
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c. The Set Target Project Information and Capture Settings Panel opens. 


InstallShield Repackaging Wizard 


Set Target Project Information and Capture Settings 
Provide the target project path and review capture settings. [m;e] 


Specify the location where Repackaging Wizard will store files created during system change 
analysis, The Repackaging Wizard output file (.inc) will be saved to this location, 


Project path to store files 
C: \Packages|PackageForTheW eb} | u 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis. 


8. Specify the Project path to store files—the directory into which the Repackaging Wizard places its 
output, including the Repackaging project file (.irp) and source files—and click Start. 


For instructions on specifying capture types for the repackaging session, see Analysis Options Dialog. 
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9. To begin the repackaging process, click Start on the Set Target Project Information and Capture Settings 


Panel. The Repackaging Panel appears, displaying the progress of the repackaging operation. 


InstallShield Repackaging Wizard 


Repackaging ... 
Please wait while InstallShield Repackaging Wizard performs system analysis. 


InstallShield Repackaging Wizard is analyzing your system and setup(s) ... 


Analyzing the system state changes... 


Cancel 


10. Following repackaging, the Summary Panel is displayed, providing confirmation that the repackaging 


was successful. 


InstallShield Repackaging Wizard 


Summary 


Review the summary information below, Click Finish to exit Repackaging 
Wizard, 


Summary: 


Repackaging Method: InstallShield Pro Log File 

Setup 1: C:\AdminStudio Shared\ProRepackage\sample\Media\Release 
1\Disk Images\Disk1\setup.exe 

Product Name: InstallShield (R) 


Output Files: 


Output file created: C:\Packages\PackageForTheWeb44\ InstallShield (R).inc 
Next Steps: 


Click Finish to launch the Repackager to edit and build your project. 


11. Click Finish to launch the Repackager to edit and build your project. 
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Selecting a Repackaging Method 


To select the repackaging method to use when repackaging a legacy setup: 


1. Launch the Repackaging Wizard from Repackager. The Welcome Panel opens. 


2. From the Welcome Panel, click Next. The Method Selection Panel opens. 


InstallShield Repackaging Wizard 


Method Selection 
Select a repackaging method. 


Oi 3 


Repacker watches lower-level system activities and records related changes made to the 
system by the setup program(s), It then analyzes these activities and stores the setup 
data in an output file which can be converted into a Windows Installer package. 


O Snapshot 


Repackaging Wizard takes an initial snapshot of the local system, runs the setup 
program(s), and then takes a second snapshot. The difference between the two 
snapshots is stored in an output file which can be converted into a Windows Installer 
package. 


3. From the Method Selection Panel, select either of the repackaging methods. 


4. Continue through the rest of the Wizard to repackage your legacy setup. 
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To edit product information for the legacy setup you are repackaging: 


1. With the Repackaging Wizard launched, step forward or backward in the Wizard until the Collect 
Product Information Panel is displayed. 


InstallShield Repackaging Wizard 
Collect Product Information 


Provide product information for repackaging, Items with asterisks (*) are 
required. 


Setup Programs 


*Program File: | C:\AdminStudio Shared\mplayer2.exe 


Command-line 
Argument(s): 


Edit Setup List 


Product Information 


*Product Name: Version: 


Product URL: http: //www.installshield, | Support URL: | http://www. installshield, 


Company Name: | InstallShield Software Corporation 


2. Modify the product information as necessary. 


3. Continue through the rest of the Wizard to repackage your legacy setup. 


Adding Additional Setup Programs 


To repackage more than one legacy installation into a single Windows Installer 
installation: 


1. Launch Repackager. 
2. Click the Repackaging Wizard button to launch the Repackaging Wizard. 
3. On the Welcome Panel, click Next. 


4. In the Method Selection Panel, select the repackaging method and click Next. 
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5. If you chose the Snapshot method in the previous step, select whether you are performing a single-step 
or multiple-step snapshot in the Snapshot Method Panel. Click Next. 


6. From the Collect Product Information Panel, provide setup information and product information for the 
first setup you are repackaging. 


7. Click Edit Setup List. The Additional Setup Programs Dialog opens. 


Additional Setup Programs 


Specify the setup programs you want to repackage. InstallShield Repackaging 
Wizard will package them into a single MSI package. 

Repackaging Wizard will run the setups in the order i 

Setup Program Command-line Argun) 


C:\AdminStudio Shared\mplayer2.exe 
C:\AdminStudio Shared\MSACCESS.... 


Setup Information 


Modify the setup location and its command-line arguments. 


Program File: 


Command-line Arguments): 


9. From the Setup Information Dialog, provide the name and location of the setup and any command-line 
arguments. Click OK to return to the Additional Setups dialog. 


10. If necessary, click the Move Up and Move Down buttons to change the order in which the setups are 
run. 


11. Click OK to return to the Collect Product Information panel. 


12. Continue through the Wizard to perform repackaging. 


If you are repackaging an InstallShield DevStudio 9.x InstallScript setup and want to use the InstallShield Professional 
Logging Method, do not specify more than one setup program. If you do, Repackager will not recognize the setup as a 
DevStudio 9.x InstallScript setup and the InstallShield Professional Setup Panel will not appear. 
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Deleting Added Setups 


To delete setups from the repackaging list: 


1. With the Repackaging Wizard launched, step forward or backward in the Wizard until the Collect 
Product Information Panel is displayed. 


InstallShield Repackaging Wizard 


Collect Product Information 
Provide product information for repackaging, Items with asterisks (*) are 
required. 


Setup Programs 


*Program File; | C:\AdminStudio Shared\mplayer2.exe 


Command-line 
Argument(s): 


Edit Setup List 


Product Information 


*Product Name: DemoShield Player Version: | 5.0 


Product URL: | http://www installshield. Support URL: | http://www. installshield, 


Company Name: | InstallShield Software Corporation 


Additional Setup Programs 


Specify the setup programs you want to repackage. InstallShield Repackaging 
Wizard will package them into a single MSI package. 


Repackaging Wizard will run the setups in the order 


Setup Program Command-line Argun’ 


C:\AdminStudio Shared\mplayer2.exe 
C:\AdminStudio Shared\MSACCESS.... 


3. From the Additional Setup Programs Dialog, select the setup you want to delete from the list and click 
Delete. 


4. Confirm the deletion. 
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Specifying the Project Path 


The project path is the directory into which the Repackaging Wizard places its output, including the Repackaging 
project file (.irp) and source files. 


To specify the project path: 


1. With the Repackaging Wizard launched, step forward or backward in the Repackaging Wizard until 
the Set Target Project Information and Capture Settings Panel is displayed. 


InstallShield Repackaging Wizard 


Set Target Project Information and Capture Settings 
Provide the target project path and review capture settings. 


Specify the location where Repackaging Wizard will store files created during system change 
analysis. The Repackaging Wizard output file (inc) will be saved to this location. 


Project path to store files 
l C:\Packages\DemoShieldS 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
future analysis. = 


2. Enter or browse to the directory you want the Repackaging Wizard to use as the project path. 


3. Continue through the rest of the Wizard to repackage your legacy setup. 
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Running the Repackaging Wizard Remotely 


For optimal performance and repackaging integrity, you should only repackage on a clean system, and you should run 
Repackager remotely from a mapped drive. This minimizes unwanted data capture during repackaging. 


To configure Repackager to run from a network location: 


On a production machine that does not contain AdminStudio, download and install a standalone 
version of InstallShield Repackager. (You will not repackage legacy setups on this machine.) 
To download the Repackager installation setup, go to the following URL: 


http: //support. installshield. com/kb/fi les/Q108601/setup. exe 


When installation is complete, the Repackager executable will be located in the following directory: 


\Program Files\Instal1Shield\Repackager\islc.exe 


Share the Repackager directory on the production machine so it can be accessed from the network. 
This can be done by right-clicking the directory in Windows Explorer and selecting Sharing from the 
context menu. 


Configure sharing rights as necessary. Click OK to close the dialog. 


From your clean system where you will repackage legacy setups, launch Windows Explorer and select 
Map Network Drive from the Tools menu. 


Specify the drive letter you want use to represent the shared location. 


Click Browse and locate the directory you shared from the production machine. Click OK once you 
select the folder. 


Click Finish to exit the Map Network Drive Wizard. 


After you have mapped the network location, you can access Repackager using Windows Explorer. 


f gı ` 


\ ea 


a 


a 
a 


To launch Repackager remotely: 


Launch Windows Explorer. 
Navigate to the drive mapped to the shared Repackager directory on your production machine. 


Navigate to the Repackager folder and double-click on islc.exe to launch InstallShield Repackager 
remotely. 


Run the Repackaging Wizard to begin repackaging your legacy setup. 
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Set the Repackaging Wizard output location to a shared directory on the production machine to ensure output files are 
written to the network rather than to the clean system. 
e (J 
Remote Repackaging on Windows NT4 


When repackaging remotely from a Windows NT4 system, you may encounter an error if MSCVRT-dll is not 
installed. To install the MSCVRT-dIl, install a standalone version of InstallShield Repackager. The Repackager 
installation setup can be downloaded at the following URL: 


http: //support. installshield. com/kb/fi 1les/Q108601/setup. exe 


Run this installation setup on a clean Windows NT system. When installation is complete, the Repackager executable 
will be located in the following directory: 


\Program Files\Instal]lShield\Repackager\islc.exe 


This will create shortcuts for Repackager and the Repackaging Wizard on the clean system. You can use them to launch 
Repackager or the Repackaging Wizard for subsequent repackaging needs. 


Running the Repackaging Wizard from the Command Line 


To run the Repackaging Wizard from the command line: 

1. Open a command-line prompt. 

2. Type isrepackager.exe followed by any command-line options you want to pass. 
3. Press Enter. 


An example of a typical command line is as follows: 


isrepackager.exe -app Setup.exe -o C:\MyRepackagedApps\Output 
-pp SomeApp -cs Custom -cf MyOptions.ini -sb 


In the above example, "-app" specifies the name of the setup, "-o" specifies the location of the output directory, "-pp" 
specified the name of the product (and the name of the Repackager output file), "-cs" specifies to use a custom 
analysis options file and "-cf" is the name of the analysis options file to use. 
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Converting a Legacy Setup 


In addition to repackaging a legacy setup using the Repackaging Wizard, you can also convert many setup types 
directly to Repackager projects (.itp)—and ultimately to InstallShield DevStudio projects (.ism) and Windows Installer 
packages (.msi). Repackager can directly convert the following setup types: 


Repackager 3.x output (.inc) 
Microsoft SMS projects (.ipf) 

Novell ZENworks projects (.axt) 
Converted WinINSTALL files (txt) 
Wise Installation projects (.wse) 
InstallShield Professional log files (.isl) 


Converting Repackager 3.x Output Files 


g 


i*\ 
2 F 


To convert a Repackager 3.x output file (.inc) to a Repackager project (which can 
subsequently be built into a Windows Installer package): 


2 
3. 
4 
5 


Launch Repackager. 

From the File menu, select Open. The Open dialog opens. 

In the Open dialog, change the Files of type filter to Legacy InstallShield Repackager Files (* inc). 
Browse to locate the Repackager 3.x output file you want to convert. 

Select the file, and click OK. 

The Repackager 3.x project is updated to the Repackager project (.irp) format. Files, INI files, shortcuts, 


and registry entries within the project are visible through the appropriate views in the Repackager 
Interface. 
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Converting Microsoft SMS Projects 


To convert a Microsoft SMS project (.ipf) to a Repackager project (which can 
subsequently be built into a Windows Installer package): 


oe Ff Ff BF 


Launch Repackager. 

From the File menu, select Open. 

In the Open dialog, change the Files of type filter to SMS Installer (*.ipf). 
Browse to locate the SMS project you want to convert. 


Select the project, and click OK. 


The legacy project is converted to a Repackager project. Files, INI files, shortcuts, and registry entries 
within the project are visible through the appropriate views in the Repackager Interface. 


Converting Novell ZENworks Projects 


@— 


InstallShield Repackager supports the conversion of a Novell ZENworks 3.0 or earlier .AXT file to an MSI package. 
However, Repackager does not support a file created with Novell ZENworks 3.1 and above, because this new version 
implements a new variable format and uses an additional variable. 


To convert a Novell ZENworks project (.axt) to a Repackager project (which can 
subsequently be built into a Windows Installer package): 


7 fF © PF 


Launch Repackager. 

From the File menu, select Open. 

In the Open dialog, change the Files of type filter to Novell ZENworks (*.axt). 
Browse to locate the ZENworks project you want to convert. 


Select the project, and click OK. 


The legacy project is converted to a Repackager project. Files, INI files, shortcuts, and registry entries 
within the project are visible through the appropriate views in the Repackager Interface. 
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Converting WinINSTALL Projects 


To convert a WinINSTALL 6.0, 6.5, or 7.x project (.txt) to a Repackager project (which 
can subsequently be built into a Windows Installer package): 


Du PS Sb 


Launch Repackager. 

From the File menu, select Open. 

In the Open dialog, change the Files of type filter to WinINSTALL (*.txt). 

Browse to locate the WinINSTALL project you want to convert. 

Select the project, and click OK. 

If the WinINSTALL Conversion dialog appears, fill in the WinlINSTALL-specific variables and click OK. 


The legacy project is converted to a Repackager project. Files, INI files, shortcuts, and registry entries 
within the project are visible through the appropriate views in the Repackager Interface. 


WinlNSTALL projects must be converted to .txt files prior to conversion to Repackager projects. 


Converting Wise Installation Projects 


H : 


To convert a Wise Installation project (.wse) to a Repackager project (which can 
subsequently be built into a Windows Installer package): 


2 
3. 
4 
5 


Launch Repackager. 

From the File menu, select Open. 

In the Open dialog, change the Files of type filter to Wise Projects (* .wse). 
Browse to locate the Wise Installer project you want to convert. 


Select the project, and click OK. 


The legacy project is converted to a Repackager project. Files, INI files, shortcuts, and registry entries 
within the project are visible through the appropriate views in the Repackager Interface. 
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Converting InstallShield Professional Log Files 


You can convert an InstallShield Professional log file (.isl) to a Repackager project if you have access to the original 
setup media. When you open the log file, following the steps below, Repackager will try to find the original setup 
media automatically (in the location specified in the log file), but if it cannot, it will allow you to browse to it before 
continuing. If you do not have access to the original setup media, the conversion will fail. 


i 


To convert an InstallShield Professional Log File (.isl) to a Repackager project (which can 
subsequently be built into a Windows Installer package): 


1. Launch Repackager. 

2. From the File menu, select Open. 

3. In the Open dialog, change the Files of type filter to InstallShield Pro Log Files (*.isl). 
4. Browse to locate the InstallShield Professional log file you want to convert. 


5. Select the file, and click OK. 


The log file is converted to a Repackager project. Files, INI files, shortcuts, and registry entries within 
the project are visible through the appropriate views in the Repackager Interface. 


InstallShield Software Corporation © 2004 240 


AdminStudio 5.5 User Guide 6 Repackaging Legacy Setups 


Configuring Exclusions 


There are three types of exclusions used when repackaging a legacy setup: 


Exclusion Type 


Description 


Repackaging 
Exclusions 


Repackaging exclusions refer to exclusions made during repackage time using the Repackaging 
Wizard. Any files, registry entries, INI files, or shortcuts excluded at this point are not included in 
the Repackager project. Therefore, if you exclude a directory you later need, you need to 
repackage the legacy setup again. 


The InstallShield best practice is to capture everything using the Repackaging Wizard, and then 
exclude visually in the Repackager Interface. This way, you avoid having to run the Repackaging 
Wizard again if you accidentally exclude necessary files. 


In some cases, you may want to avoid capturing specific data types during repackaging. For 
example, your organization may never want to capture shortcuts. You can disable capture of 
shortcuts during repackage time, thereby eliminating the need to exclude them later. In snapshot 
mode, you may want to limit the analysis to a certain directory to reduce the time it takes to 
capture the initial and final snapshot. 


Global Project 
Exclusions 


Each Repackager project can use a global project exclusion list which marks files, registry 
entries, shortcuts, and INI files as excluded in the Repackager project. If your process dictates 
that you capture everything and only exclude items in the Repackager Interface, then you should 
set up commonly captured but unnecessary items from the project by default. Because all the 
data from the original capture is intact, if you accidentally exclude necessary files, you can 
always reinclude them from the Repackager Interface and quickly rebuild your Windows Installer 
package. 


Individual Project 
Exclusions 


Because each project is different, and may require you to make decisions as to whether certain 
captured data is necessary, you can also selectively exclude or reinclude items on a per-package 
basis. These individual project exclusions allow you a fine-level of control as you prepare to build 
your Windows Installer package from the Repackager project. 
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Excluding Files 


gi 


Bi 
To exclude a captured file from the DevStudio project and Windows Installer package: 


1. Select Files and Folders from the View List. The Files and Folders View opens. 


InstallShield®.irp - InstallShield Repackager 


File view Project Build Tools Help 


Captured Installation Files and Folders 
|) Files and Folders Summary 
Registry Entries 
{Gy Shortcuts 
E A Repackaged Output 0 files will be excluded. 
g Package Information 


Advanced Settings Exclude all Include 


m- [ProgramFilesFolder] Name Size (bytes) Version Language Condition 


136 files were captured. 


a © [CommonFilesFolder] P] Color Management Off.csf 563680 English 
I ( Adobe P Emulate Acrobat 4.csf 139438 English 


SE Color i |_] Emulate Photoshop 4.csf 729048 English 
w- Profiles e 


© a Europe Prepress Defaults.csf 563180 English 

E TypeSpt P) Japan Prepress Defaults.csf 563144 English 

E Acrobat 5.0 H Photoshop 5 Default Spaces.csf 730900 English 

8) [SystemFolder] ) US Prepress Defaults. csf 563132 English 
(=) [AppDataFolder] a Web Graphics Defaults.csf 564604 English 


H-E [PersonalFolder] 


$ 


2. Expand the directory tree and select the directory containing the file you want to exclude. 


3. In the file list, right-click on the file and select Exclude. 
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Excluding All Files in a Directory 


To exclude all captured files in a directory from the DevStudio project and Windows 
Installer package: 


1. Select Files and Folders from the View List. The Files and Folders View opens. 


InstallShield®.irp - InstallShield Repackager 
File View Project Build Tools Help 


a | 


Captured Installation Files and Folders 
__] Files and Folders F Summary 
g Registry Entries 
Ez] Shortcuts 

g @ Repackaged Output 0 files will be excluded, 
g Package Information 


Advanced Settings Exclude all Include 


a- [ProgramFilesFolder] Name Size (bytes) Version Language Condition 


136 files were captured. 


= [CommonFilesFolder] L) Color Management Off.csF 563680 English 
5- Adobe _] Emulate Acrobat 4.csf 139438 English 


sy ® n fil __) Emulate Photoshop 4.csF 729048 English 
rofiles E : 
So O Europe Prepress Defaults.csf 563180 English 


M Japan Prepress Defaults.csf 563144 English 

E Acrobat 5.0 O Photoshop 5 Default Spaces.csf 730900 English 
H-E [SystemFolder] 0 US Prepress Defaults.csf 563132 English 
S- [AppDataFolder] 0O Web Graphics Defaults.csf 564604 English 


-E [PersonalFolder] 


E TypeSpt 


2. Expand the directory tree and select the directory containing the files you want to exclude. 


3. Right-click on the directory and select Exclude. 
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Excluding Directories and Subdirectories 


To exclude all captured files and subdirectories within a directory from the DevStudio 
project and Windows Installer package: 


1. Select Files and Folders from the View List. The Files and Folders View opens. 


InstallShield®.irp - InstallShield Repackager 
File View Project Build Tools Help 
% | of 


Captured Installation Files and Folders 
[_] Files and Folders Summary 
g Registry Entries 
Ez] Shortcuts 

g @ Repackaged Output 0 files will be excluded, 
g Package Information 


Advanced Settings Exclude all Include 


a- [ProgramFilesFolder] Name Size (bytes) Version Language Condition 


136 files were captured. 


= [CommonFilesFolder] L) Color Management Off.csF 563680 English 
S-E Adobe (emulate Acrobat 4.csf 139438 English 


sy ® n fil __) Emulate Photoshop 4.csF 729048 English 
+ rofiles E : 
So O Europe Prepress Defaults.csf 563180 English 


B) Japan Prepress Defaults.csf 563144 English 

© Acrobat 5.0 L] Photoshop 5 Default Spaces.csf 730900 English 
S-E [SystemFolder] 0 US Prepress Defaults.csf 563132 English 
E-E [AppDataFolder] L] Web Graphics Defaults.csf 564604 English 


5) [PersonalFolder] 


E TypeSpt 


2. Expand the directory tree to display the directory containing the files and subdirectories you want to 
exclude. 


3. Right-click on the directory and select Exclude All. 
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Excluding Registry Keys 


To exclude a registry key from the DevStudio project and Windows Installer package: 


1. Select Registry Entries from the View List. The Registry Entries View opens. 


InstallShield (R).irp - InstallShield Repackager 
File view Project Build Tools Help 
(6H tte 84 & 
z- Captured Installation Registry Entries 
| Files and Folders Summary 


i A raer P 5 registry entries were captured. 
(4g) Repackaged Output Oregistry entries will be excluded. 


FF Package Information 
Advanced Settings Exclude all Exclude Include 


=) (=) HKE'Y_CURRENT_USER Name Type Value 
i Software ad) Iswubble REG_BINARY 31 
S- Installshield ab) Wwubble  REG_SZ Yes, I said "wubble" 
(= 
S-E HKEY_LOCAL_MACHINE 
5- Software 
B-E InstallShield 
B- sample 
Œ 1.00.0000 


2. Expand the Registry tree to display the registry key you want to exclude. 


3. Right-click on the registry key and select Exclude. 
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Excluding Registry Values 


To exclude a captured registry value from the DevStudio project and Windows Installer 
package: 
1. Select Registry Entries from the View List. The Registry Entries View opens. 


InstallShield (R).irp - InstallShield Repackager 
File view Project Build Tools Help 


Captured Installation Registry Entries 
3 Files and Folders Summary 
Reus 5 registry entries were captured 
-KEA Shortcuts ' 
(4g) Repackaged Output Oregistry entries will be excluded. 


FF Package Information 
Advanced Settings Exclude all Exclude Include 


S- HKE'Y_CURRENT_USER Name Type Value 
5- Software g}IsWubble REG_BINARY 31 
S- Installshield ab) Wubble  REG_SZ Yes, I said "wubble" 
© 
S-E HKE'Y_LOCAL_MACHINE 
a- Software 
=) InstallShield 
=) sample 
© 1.00.0000 


2. Expand the Registry tree and select the registry key containing the value you want to exclude. 


3. In the Registry Value list, right-click on the value and select Exclude. 
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Excluding INI Files 


To exclude a captured INI file from the DevStudio project and Windows Installer 
package: 


1. Select INI Files from the View List. The INI Files View opens. 


Realplayer8.irp - InstallShield Repackager 


File view Project Build Tools Help 


Obl t+es EIC 


Captured Installation INI file entries 


3 Files and Folders Summary 

Registry Entries 9 ini entries were captured. 
Shortcuts 

2 INI Files 0 ini entries will be excluded. 


a ce} Repackaged Output 


g Package Information Exclude File Exclude Section Include Section Include File 


Advanced Settings 


B- %FavoritesFolder%\Links\RealPlayer.ul | Name Value 
SC) %FavoritesFolder%|MedialReal.com Re [3] IconFile  %ProgramFilesFolder%\Real\RealPlayer\RealPlay.exe 
E InternetShortcut È) Icontndex 0 


H-E %FavoritesFolder%\RealPlayer Home P E) URL http: /frealguide.real.com/stations/ 


2. Expand the INI Files tree to display the INI file you want to exclude. 


3. Right-click on the INI file and select Exclude. 
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Excluding INI File Sections 


To exclude a section in a captured INI file from the DevStudio project and Windows 
Installer package: 


1. Select INI Files from the View List. The INI Files View opens. 


Realplayer8.irp - InstallShield Repackager 


File view Project Build Tools Help 


a aS 


Captured Installation INI file entries 


3 Files and Folders Summary 

Registry Entries 9 ini entries were captured. 
Shortcuts 

a INI Files 0 ini entries will be excluded. 


Es El Repackaged Output 


g Package Information Exclude File Exclude Section Include Section Include File 


Advanced Settings 


E- %FavoritesFolder%\Links\RealPlayer.ul | Name Value 
a SFavoritesFolder\Media\Real.com Rë | (5) IconFile  %ProgramFilesFolder%\RealiRealPlayer\RealPlay.exe 
E InternetShortcut E) Icontndex 0 


H-E %FavoritesFolder%\RealPlayer Home P (3) ure http:,/realquide.real.com/stations/ 


2. Expand the INI Files tree to display the INI file containing the section you want to exclude. 


3. Right-click on the section and select Exclude. 
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Excluding Shortcuts 


To exclude a captured shortcut from the DevStudio project and Windows Installer 
package: 


1. Select Shortcuts from the View List. The Shortcuts View opens. 


DER 


InstallShield®.irp - InstallShield Repackager 
File Yiew Project Build Tools Help 


Captured Installation ra Shortcuts 
a Files and Folders L Summary 
Registry Entries 2 shortcuts were captured. 


(EA Shortcuts 
GQ Repackaged Output 0 shortcuts will be excluded, 


Package Information 
Advanced Settings Exclude all Include 


B- [ProgramMenuFolder] Auer EA 
laf Acrobat Distiller 5.0 Description Acrobat Distiller 5.0 
S- [StartupFolder] Command — [ProgramFilesFolderJAdobe\Acrobat 5, 0\Distillr\acrodist exe 
E Acrobat Assistant Working Dir [ProgramFilesFolder]Adobe\Acrobat 5.0\Distillr 
Icon File [ProgramFilesFolder Adobe Acrobat 5,0\Distillr\acrodist.exe}, 


Icon Index 0 


2. Expand the Shortcuts tree to display the shortcut you want to exclude. 


3. Right-click on the shortcut and select Exclude. 
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Excluding All Shortcuts in a Directory 


To exclude all captured shortcuts in a directory from the DevStudio project and Windows 
Installer package: 


1. Select Shortcuts from the View List. The Shortcuts View opens. 


InstallShield®.irp - InstallShield Repackager 


Captured Installation Shortcuts 
|_] Files and Folders Summary 
@Y Registry Entries 2 shortcuts were captured. 
{Ey Shortcuts 
(gg Repackaged Output 


Package Information 
Advanced Settings Exclude all Include 


0 shortcuts will be excluded, 


5-6 [ProgramMenuFolder] Rear oul vale 
E Acrobat Distiller 5.0 

EE (StartupFolder] 
Acrobat Assistant 


2. Expand the Shortcuts tree to display the directory containing the shortcuts you want to exclude. 


3. Right-click on the directory and select Exclude. 
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Excluding Shortcuts from Subdirectories 


To exclude all captured shortcuts within a directory or its subdirectories from the 
DevStudio project and Windows Installer package: 


1. Select Shortcuts from the View List. The Shortcuts View opens. 


InstallShield®.irp - InstallShield Repackager 


Captured Installation Shortcuts 
|_] Files and Folders Summary 
@Y Registry Entries 2 shortcuts were captured. 
{Ey Shortcuts 
(gg Repackaged Output 


Package Information 
Advanced Settings Exclude all Include 


0 shortcuts will be excluded, 


5-6 [ProgramMenuFolder] Rear oul vale 
E Acrobat Distiller 5.0 

EE (StartupFolder] 
E Acrobat Assistant 


2. Expand the Shortcuts tree to display the directory containing the shortcuts and/or subdirectories 
containing shortcuts you want to exclude. 


3. Right-click on the directory and select Exclude All. 
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Specifying the External Configuration File 


To specify an external configuration file which you want to use as a filter when 
converting legacy setups: 


1. From Repackager Project menu, select Properties. The General tab of the Project Properties Dialog 
opens. 


2. Select the Global Exclusions tab. 


Project Properties 
General) Global Exclusions 


© Do not use any extemal configuration file 


© Use settings from the shared location 
O Use settings from InstallShield Defaults 
© Use settings from a custom file 


‘\4schO1 sevuganaxp\data\CabS cope4crobat Distiller 5.0.5\output\Options. ini 


Browse... | | 


3. Select which configuration file to use. If you are using a custom file, specify the file's name and 
location. 


4. Click OK. 


When you apply a configuration file, Repackager automatically updates all views to reflect the configuration file's 
exclusions. However, if you have already excluded items using Repackager, item states are retained. 
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Modifying External Configuration Files 


To configure an external configuration file: 


1. From Repackager's Project menu, select Properties. The General tab of the Project Properties Dialog 
opens. 


2. Select the Global Exclusions tab. 


Project Properties 
General) Global Exclusions 


© Do not use any extemal configuration file 


© Use settings from the shared location 
© Use settings from InstallShield Defaults 
© Use settings from a custom file 


\\sch01 sevuganaxp\data\CabS cope‘ Acrobat Distiller 5.0.5\output\Options. ini 


Browse... | | 


3. Verify the file you want to modify is specified. 
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4. Click Edit. The Global Exclusions Editor launches. 


*: Options.ini - Global Exclusions Editor 
File Help 


pamm ee 
INI Files || Registry 


Specify the files you want automatically marked as excluded in your Repackager 
Project. 


Edit Exclusions... Reset to Default Values 


5. Make necessary modifications using the Global Exclusions Editor. 

6. When you finish editing the configuration file, select Save from the Global Exclusion Editor's File menu. 
7. Select Exit from the Global Exclusion Editor's File menu. 

8. Click OK to close the Project Properties dialog. 


When you apply a configuration file, Repackager automatically updates all views to reflect the configuration file's 
exclusions. However, if you have already excluded items using Repackager, item states are retained. 
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Building DevStudio Projects and MSI 
Packages 


You can directly build an InstallShield DevStudio project (ism) and Windows Installer package (.msi) from your 
Repackager project (irp). However, before you do so, you must configure options in your Repackager project 
necessary for the build. 


To build a DevStudio project (.ism) and Windows Installer package (.msi): 


1. Select Repackaged Output from the View List. The Repackaged Output View opens. 


Realplayer8.irp - InstallShield Repackager 


Captured Installation Repackaged Output 
a Files and Folders Package Settings and Conversion Options 
Registry Entries 
Shortcuts Repackaged Output Summary 
INI Files 


DevStudio Project: W:\repackager\template\realplayer\Realplayers.ism 


z Package Information 
Advanced Settings Windows Installer Package: (not built) 


Repackaged Output Options 


Create a Windows Installer package (.msi) after creating the DevStudio project 
Build a compressed, single-file package that contains all of the files. 
[C] Create a Setup.exe to launch the package 


@ Use the default DevStudio template 


© Use a customized template 


2. Specify the name and location of the DevStudio Project file you want to create. 


3. Configure Repackaged Output Options as necessary. This includes whether you want to create a 
Setup.exe file, and what template to use when creating the project. 
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4. Select Package Information from the View List. The Package Information View opens. 


Realplayer8.irp - InstallShield Repackager 
File View Project Build Tools Help 


(OH tte 


Captured Installation Package Information 
|) Files and Folders SS" Summary 
Registry Entries 
a Shortcuts Windows Installer Package 


i INI Files ~ 
(gg Repackaged Output 


g Package Information Company Name: | RealNetworks, Inc. 


Advanced Settings 


Product Name: | Realplayer8 


Version: 88.0.9.432 


Product URL: http: jwaww. mycompany.com 


Support URL: http://support.mycompany.com 


5. Provide values for the properties in this view. 
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6. Select Advanced Settings from the View List. The Advanced Settings View opens. 


Realplayer8.irp - InstallShield Repackager 


File view Project Build Tools Help 


Oh tte 


Captured Installation 
Files and Folders 
Registry Entries 
Shortcuts 
a INI Files 
E] éa Repackaged Output 
g Package Information 


HCE 


$ Advanced Package Settings 


eea Captured Data Conversion Settings 


Package Conversion 


Use DevStudio path variables instead of physical source paths. 

Display only the Welcome dialog during installation. 

[M] Replace files with merge modules whenever possible, 

[Use the language captured by the Repackager as the language of the setup 


Include files from Setup Intent scan 


Component Settings 


Mark components destined For the System Folder as permanent. 
Mark components destined for the CommonFiles folder as shared. 
Map registry data to the appropriate COM tables, 

[C] Map registry data to the appropriate ODBC tables. 


[C] Map NT Service events to the ServiceControl table. 


InstallShield SmartScan Settings 


Include files From InstallShield legacy media scan 


C] Exactly match legacy setup's Operating System requirements 


7. In the Advanced Settings View, configure settings as necessary. 


8. Select Repackaged Output on the View List and then click the Build button. 
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Configuring Advanced Conversion Options 


To configure advanced conversion options: 


1. Select Advanced Settings from the View List. The Advanced Settings View opens. 


Realplayer8.irp - InstallShield Repackager 
File view Project Build Tools Help 
Oh ttep 
Y Captured Installation g Mb Advanced Package Settings 
|] Files and Folders Qf Captured Data Conversion Settings 
g Registry Entries 
Shortcuts Package Conversion 
~~ INI Files 
St t=) Repackaged Output 
g Package Information 
Advanced Settings Display only the Welcome dialog during installation, 


Use DevStudio path variables instead of physical source paths. 


[M] Replace Files with merge modules whenever possible, 
Cluse the language captured by the Repackager as the language of the setup 


[MJ Include files From Setup Intent scan 


Component Settings 


Mark components destined For the System Folder as permanent. 


Mark components destined For the CommonFiles folder as shared. 


Map registry data to the appropriate COM tables, 
[C] Map registry data to the appropriate ODBC tables, 


[C] Map NT Service events to the ServiceControl table, 


InstallShield SmartScan Settings 


Include files from InstallShield legacy media scan 


oO Exactly match legacy setup's Operating System requirements 


2. In the Advanced Settings View, select the options you want to use during conversion. 


InstallShield Software Corporation © 2004 258 


AdminStudio 5.5 User Guide 6 Repackaging Legacy Setups 


Editing Generated Projects and Packages 
in DevStudio 


After building your Repackager project into a Windows Installer package and/or a DevStudio project, you may want 
to launch DevStudio for additional modifications. 


ras 
2 


Bi 


To launch the generated DevStudio project (.ism) in DevStudio: 


From the Repackager Project menu, select Edit InstallShield DevStudio Project. If installed, DevStudio 
opens the project file. 


Bi. 
To launch the generated Windows Installer package (.ism) in DevStudio: 


From the Repackager Project menu, select Edit Windows Installer Package. If installed, DevStudio opens 
the package in Direct MSI Edit mode. 
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Viewing Repackager Project Properties 


To view properties for the current Repackager project: 


1. From the Project menu, select Properties. The General tab of the Project Properties dialog opens. 


Project Properties 


General | Global Exclusions | 


Project Location: 
C:\Packages\PackageF orT heWeb : 


Project file: 
PackageForT heWeb 4. irp 


Captured data file: a 
PackageForTheWeb 4. inc 


Registry data file: 


Bee 


Conversion options file: 


0 ptions. ini 


DevStudio project file: 
PackageForTheWeb 4.ism 


Windows Installer package: 
PackageF orT he\Web 4. msi 


Apply 


2. When finished viewing properties in the General tab, click OK. 
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Creating Reports 


We 


To create a report detailing captured data: 


1. From the Project menu, select Create Report. The Create Report Dialog opens. 


Create Report 


Report Options 


Current view only 
Indicate excluded items 


Report File Format 
@HTML O Text 


2. Select whether you want the report to contain data from the entire capture, or just the current view. 


3. If you want the report to contain data from the entire capture, specify whether you want to just display 
summary information. 


4. Specify whether you want to display excluded items in the report. 
5. Select the file format for the report. You can generate an HTML report or a text report. 


6. Click OK. A Save As dialog opens. 


Save in: O output 


> Data 

© CommorFilesFolder 

[O ProgramFilesFolder 
\)ProgramFilesFolderAdobe 
(CasystemFolder 


L 


Save as type: | Web Pages [*.htm; * html] i 


7. From the resulting Save As dialog, browse to the location where you want to save the file, and provide 
a name for the report. 


8. Click OK. The report is saved to the specified location and automatically opened. 
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Changing Data Type Appearance 


To change the way excluded and included data is displayed in Repackager: 


1. From the Tools menu, select Options. The Colors tab of the Options Dialog opens. 


Options 


Colors | Merge Modules | 


Data Item Colors 


Excluded items: 


SmartScan items: 


Setup Intent items: 


2. Configure the display colors for Excluded, SmartScan, and Setup Intent items. 


3. Click OK. 
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To detect file dependencies that may not be included in your Repackager project (.irp): 


1. From the Project menu, select Setup Intent Wizard. The Welcome Panel opens. 


Setup Intent Wizard 


Welcome to the Setup Intent Wizard 


This wizard will scan the project for dependency files 
that were not installed by the original setup but must be 
installed in order for the application to execute 
properly. 


The source files for your project must exist in order for 
this scan to succeed. 


Click Next to continue. 


me (reo) 


2. From the Welcome panel, click Next. The Scanning Project Panel opens. 


Setup Intent 


Scanning Project 
The project is being scanned. 


File: \\schO sevuganaxp\data\CabS cope\Acrobat Distiller 5.0.5'output\ProgramFilesF olde 


Cea] (He) 
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3. Once scanning is finished, the Results Panel opens, listing new files that your setup requires. 


Setup Intent 


Results 
New files that your setup requires have been discovered. 


Select the files to add to your project, then click Finish. 


.\ProgramFilesFolder\4dobe\Acrobat 5.0\Distill\CoolT ype. dll 


Ere es | 


4. From the Results Panel, select the files you want added to your Repackager project and click Finish. 


5. Save your Repackager project. 


Because the Setup Intent Wizard analyzes files in the Repackager project and searches for dependent files, you must 
run the Setup Intent Wizard from the same machine where repackaging was performed (with the Repackaging 
Wizard). You can then save the Repackager project and transfer it to another machine. 


If you are repackaging a legacy setup that was originally created using InstallShield Professional 5.5 and later, you can 
use the InstallShield SmartScan Wizard to scan the setup for possible additional files, INI files, shortcuts, or registry 
data (such as for language-specific setups or platform-specific setups). 


The SmartScan Wizard is also able to group files, shortcuts and registry entries into features corresponding to 
InstallShield Professional components. Any items (files, folders, shortcuts, or registry entries) that are attached to a 
component directly or indirectly (through File Groups), are attached to their corresponding features. 


=| Y Features 
©) DemoPlayerApp 
© InstallShieldProDemo 
©) DemoShieldDemo 
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Automatic Launch of the SmartScan Wizard 


For your convenience, if a Repackaging project is opened (either by using Open on the File menu or by using the 
Repackaging Wizard), and the project meets certain conditions, the SmartScan Wizard is automatically launched. The 
SmartScan Wizard is launched: 


m if the original setup was an InstallShield Professional 5.5+ setup, AND 


E the file has not already been repackaged using the InstallShield Professional Logging Method (available for 
InstallShield DevStudio 9.x InstallScript setups only), AND 


@ the InstallShield SmartScan Wizard has not already been run on this project 


To scan an InstallShield Professional setup: 


1. From the Project menu, select InstallShield SmartScan Wizard. The Welcome Panel appears. 


InstallShield SmartScan Wizard 


Welcome to the InstallShield 
SmartScan Wizard 


This wizard will scan the original media for setup 
information that was not captured on the original target 
system but might be applicable on other operating 
systems or languages, so that your new setup can be 
more portable. 


Before continuing, make sure that you have set the 
Original Target Folder in the Captured Installation View. 


Click Next to continue. 
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2. Click Next. The Original InstallShield Professional Setup Panel appears. 


Scan InstallShield Professional Media 


Original InstallShield Professional Setup 
Specify original Pro setup and password 


Specify the path of the original setup executable. 


[C:\AdminStudio Shared\ProRepackage\sample\Media\Release 1\ | 


Specify password if required. 


3. The original setup edit field will be filled in by default if that information exists. Browse to the 
InstallShield Professional setup you want to scan, specify a password if required, and click Next. The 
Scanning Panel appears. 


Scan InstallShield Professional Media 


Scanning 
Scanning InstallShield Professional Setup for data to add 


Scanning InstallShield Professional Setup... 


Done 


InstallShield Software Corporation © 2004 266 


AdminStudio 5.5 User Guide 6 Repackaging Legacy Setups 


4. When scanning is complete, click Next. The Setup Feature Tree Panel appears, listing the features and 
components that were configured in the InstallShield Professional project. 


Scan InstallShield Professional Media 


Setup Feature Tree 
Choose to add feature information 


The setup information can be partitioned into the following features. 


DefaultFeature 


5. Select the Add feature tree option if you want to use the feature information defined in the Professional 
media. Click Next. The Scanning Media Panel appears, showing the results of Repackager's search for 
any extra setup information in the media. 


Scan InstallShield Professional Media 


Scanning Media 
Searching for extra setup information in the media 


Wednesday, January 07, 2004 10:30:344M 
Scanning InstallShield Professional setup: C:\AdminStudio Shared\ProRepackage\sample\M 
Script-defined data that cannot be added to the project will be highlighted in red. 
File: [INSTALLDIR]\NOTEPAD.EXE 
File: [INSTALLDIR]\Prairie Wind. bmp 
File: (INSTALLDIR]\Santa Fe Stucco.bmp 
ile: <DISKITARGET>\layout.bin 
ile: <DISKITARGET>\datal .hdr 
ile: <DISKITARGET>\datal cab 
ile: <DISKITARGET>\setup.exe 
ile: <DISKITARGET>\setup.inx 
ile: <DISKI TARGET >\setup.ini 
Shortcut: [DesktopFolder]\Notepad Shortcut Target file: INSTALLDIR]\NOTEPAD.EXE 
Registry entry: [HKEY_CURRENT_USER Software] Value: @= v 


MIV MIMMCTPL Wt. b he bent) Seah ne 28 


Mm | > 


6. Click Finish to apply the results to the project. The setup is scanned, and any additional files, shortcuts, 
INI files, or registry data is added to the appropriate view. This text appears in the color designated in 
the Colors tab of the Options Dialog. Also, if you selected the Add feature tree option, the files, 
shortcuts and registry entries are grouped into features corresponding to the InstallShield Professional 
components. 
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After you have scanned an InstallShield Professional project and included data from it in your Repackager project, you 
can save the project. When you reopen it, this collected data no longer retains the "scanned" color, since it is now part 
of the Repackager project. 


Saving Repackager Projects 


To save the current Repackager project: 


Select Save from the File menu. 
_OR- 


Click the Save bell button on the toolbar. 


To save the current Repackager project under a different name: 


Select Save As from the File menu. 
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Repackager Reference 


This section describes each of the dialog boxes and Wizard panels that you might encounter throughout Repackager. 
The help topics in the Repackager Reference are the same detailed documentation that is displayed when you press 
the F1 key or click the Help button while working in a dialog. 


Reference information is organized as follows: 


Reference Topics 


©) Repackager Interface 


This section contains reference information pertaining to the Repackager Interface itself. This includes menus, the 
toolbar, views, and dialog boxes. 


(2) Repackaging Wizard 
A This section provides a panel-by-panel description of the Repackaging Wizard. 


EZ) Setup Intent Wizard 
A 


This section provides information about the Setup Intent Wizard user interface. 


\ Options.ini Fil 
2) ptions.ini File 


The Options.ini file, which contains information used in repackaging, is discussed in this topic. 


© Files Associated with Repackager 


This topic describes the various files related to or created by repackaging. 
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Repackager Interface 


The Repackager Interface allows you to repackage legacy setups (using the Repackaging Wizard), configure global 
exclusions (using the Global Exclusions Editor), convert Novell ZENworks (3.0 or earlier), Microsoft SMS, and 
WinINSTALL projects into Repackaging projects, create a package exclusion list, and build the project into an 
InstallShield DevStudio project and Windows Installer package. 


The Interface consists of several menus, a toolbar, the status bar, the output window, the View List, and several 
associated views. Menus and the toolbar are discussed in the Menus and Toolbars topic; the status bar, output 
window, and View List are described in the following table. Individual views are covered in their respective help 
topics. 


Interface Element Description 


Status Bar The status bar, which can be toggled from the View menu, displays information when you 
hover over buttons in the toolbar. 


View List The View List allows you to navigate to different views in the Repackager project. The 
corresponding view is displayed when you select an item in the tree. You can also use the 
Forward, Back, Navigate Up, and Navigate Down buttons in the View List. 


The View List includes the following views: 


= Captured Installation View 

a Files View 

= Registry Entries View 

= Shortcuts View 

a INI Files View 

a Deleted Files View 

= Deleted Registry Entries View 
= Repackaged Output View 

= Package Information View 

= Advanced Settings View 


Output Window When you open Repackager 3.x output, Novell ZENworks projects, Microsoft SMS projects, 
WinlNSTALL projects, or Wise installation projects in the Repackager Interface, conversion 
information appears in the Output window. This window can be toggled from the View menu. 
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Welcome to InstallShield Repackager Page 


When you first launch Repackager, the Welcome to InstallShield Repackager page is displayed. 


InstallShield Repackager 
File View Project Build Tools Help 
(OH tte > Se 


H 
Welcome to InstallShield Repackager = 


@ Open an existing project, convert from a legacy project, or capture a new setup: 


Open an existing project 
Start the InstallShield Repackaging Wizard to capture a new setup 


Upgrade a legacy InstallShield Repackager file (*.inc} 


Convert a legacy project into a new Repackager project. 
You can import an existing WinInstall, Zenworks, SMS, or Wise project. 


Reopen project: C:\Packages\PackageForTheWeb44\InstallShield (R}.irp 


@ Fine-tune the captured setup data 
E) Review the captured data, and exclude unnecessary items 
J Scan for setup intent 


B Scan an InstallShield setup 


@ Build a Windows Installer package and enhance with InstallShield DevStudio 


Build a DevStudio Project and a Windows Installer package 


EÑ Edit the Windows Installer package using DevStudio 


This page gives you a brief overview of Repackager functionality and uses, and allows you to open an existing 
Repackager project (irp), convert a legacy setup, launch the Repackaging Wizard, or open a recently accessed package. 
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The following table provides a description of each menu command and toolbar button: 


Menu Command Toolbar Keyboard Description 
Button Shortcut 
File Open eS Ctrl+O Allows you to open an existing Repackager project (.irp), 
Repackager 3.x output (.inc), Novell ZENworks 3.0 or 
earlier project (.axt), Microsoft SMS project (.ipf), 
WinlNSTALL converted project (.txt) (6.0, 6.5, and 7.x), or 
Wise Installer project (.wse). 
File Save jd Ctrl+S Saves the current project. 
File Save As Saves the current project using the name and location you 
specify. 
File 1,2,3,4 Allows you to open the four most recently accessed 
Repackager projects. 
File Exit Exits Repackager. 
View Toolbar Toggles display of the toolbar. 
View Status Bar Toggles display of the status bar. 
View Output Toggles display of the Output window. 
View Refresh F5 Refreshes the current view. 
Project Edit Once you build the Repackager project into a Windows 
Windows Installer package (.msi), opens the package in DevStudio (in 
Installer Direct MSI Edit mode). 
Package 
Project Edit Once you build the Repackager project into a DevStudio 
InstallShield project (.ism), opens the DevStudio project in DevStudio. 
DevStudio 
Project 
Project Setup Intent Launches the Setup Intent Wizard. 
Wizard 
Project InstallShield Launches the InstallShield SmartScan Wizard, which allows 
SmartScan you to scan an InstallShield Professional setup for additional 
Wizard files that may not have been captured during repackaging 
because they may be language- or platform-specific. 
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Menu Command Toolbar Keyboard Description 
Button Shortcut 
Project Create Ctrl+R Allows you to create a report for the project in text or HTML 
Report format. 
Project Properties Displays properties for the current project, including global 
exclusion information. 
Build Build F7 Builds the Repackager project into a DevStudio project and 
a Windows Installer package. 
Build Stop Build Ctrl+Break Terminates an in-process build. 
Tools Repackaging ¿$ Launches the Repackaging Wizard. 
Wizard 
Tools VMware Launches the VMware Repackaging Wizard. 
Repackaging 
Wizard 
Tools Global Launches the Global Exclusions Editor. 
Exclusions 
Editor 
Tools Options Displays the Options dialog. 
Help Contents Launches the Help Library, displaying the Contents tab. 
Help Index Launches the Help Library, displaying the Index tab. 
Help Search Launches the Help Library, displaying the Search tab. 
Help Support Accesses AdminStudio Support Central on the Web. 
Central 
Help InstallShield Accesses the AdminStudio Community on the InstallShield 
Community Web site. 
Help ReadMe Displays the AdminStudio ReadMe file. 
Help Feedback Accesses the AdminStudio feedback form on the InstallShield 
Web site. 
Help InstallShield Accesses the InstallShield Web site. 
on the Web 
Help About Displays the About Repackager dialog. 
Repackager 
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Menu Command Toolbar Keyboard Description 
Button Shortcut 


Up € Moves you up one view in the View List. 

Down $ Moves you down one view in the View List. 

Back = Displays the previously displayed view in the View List. 
Forward => Returns you to the view from which you selected the Back 


button. 


Repackager includes the following dialogs to assist you in your project creation. 


About Repackager Dialog 


This dialog, available by selecting About Repackager from the Help menu, displays version information for 
AdminStudio. 


Create Report Dialog 


The Create Report dialog, available by selecting Create Report from the Project menu, allows you to configure a 
report for the current Repackager project, or a specific subset of captured data. 


Create Report 


Report Options 


C] Summary only 


Indicate excluded items 


Report File Format 
@HTML OText 


This dialog contains the following fields: 


Property Description 


All captured data (files, Select to have the report include all captured data. 
registry entries, 
shortcuts, etc.) 
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Property Description 


Summary only If you select All captured data, you can select this option to only display summary information 
in the report (the number of items captured and the number of items excluded for files, INI 
files, registry data, and shortcuts). 


Current view only Select this option to include only the currently selected view in the report. 


Indicate excluded items Select to display items that have been marked as excluded in Repackager. 


Report File Format Select the file format for Repackager reports: HTML or Text. 


Create When you click Create, you are prompted for a name and location for the outputted report. 


Options Dialog 


The Colors tab of the Options dialog, available from the Tools menu, allows you to configure the color of scanned 
items and deleted items in Repackager's exclusion views (Files, INI Files, Registry Data, and Shortcuts). 


Options 


| Colors | Merge Modules) _ 


| Data Item Colors 


Excluded items: 


SmartScan items: 


Setup Intent items: 
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On the Merge Modules tab you can specify additional directories containing custom merge modules to use during 
repackaging. 
Options 


Ls 
| Colors | Merge Modules | 
Additional Merge Module Path 


If you have custom merge modules that should be used when building the Windows Installer 
package, enter the path to those merge modules here. If you specify multiple locations, 
separate the folder paths with commas. 


| 
Browse... 


Password Required Dialog 


The Password Required dialog is displayed when attempting to run the InstallShield SmartScan Wizard on an 
InstallShield Professional setup which requires a password. Provide the password for the setup and click OK to 
proceed. 


For InstallShield Professional 6.x and 7.x setups, the SmartScan Wizard can bypass password protection, and will not 
prompt you for a password even if one is required to run the installer. 


e e 
Project Properties Dialog 
The Project Properties dialog, accessed by selecting Properties from the Projects menu, contains two tabs: 


m General Tab—Allows you to view properties for the current Repackager project. 


m Global Exclusions Tab—Use to configure the location of the default global exclusion file. 
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General Tab 
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The General tab of the Project Properties dialog displays information about the current Repackager project (.irp). 


Project Properties 


| General | Global Exclusions 


Project Location: 


| C:\Packages‘\PackageF orT heWeb 


Project file: 


|PackageForTheWeb 4.irp 


Captured data file: 
|PackageForT heWeb 4. inc 


Registry data file: 


| Updated. isr 3 


Conversion options file: 
| Options. ini 


DevStudio project file: 


| PackageForTheweb 4.ism 


Windows Installer package: 


|PackageForTheweb 4 msi 


The following properties are displayed: 


Property 


Description 


Project location 


The full path of the current Repackager project file (.irp). 


Project file 


The name of the current Repackager project file. 


Captured data file 


The name and location of the captured data file (.inc), which was either created by the 
Repackaging Wizard or during conversion of a Novell ZENworks project, Microsoft SMS project, 
or WinINSTALL project. The path is relative to the current Repackager project file. 


Registry data file 


The name and location of the file containing captured registry data. The path is relative to the 
current Repackager project file. 


Conversion options 
file 


The name and location of the Options. ini file, which contains an exhaustive list of all options you 
can use during conversion of the Repackager project to an InstallShield DevStudio project and 
Windows Installer package. Commonly used options are exposed in the Product View (MSI 
Package), Advanced Settings view, and Build view. 


DevStudio project 
file 


The name and location of the DevStudio project file as set in the Product View (MSI Package). The 
path is relative to the current Repackager project file. 


Windows Installer 
package 


The name and location of the Windows Installer package. The path is relative to the current 
Repackager project file. 
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Global Exclusions 


The Global Exclusions tab allows you to select a global exclusion file to use as a filter when importing captured data 
into a Repackager project. 


Project Properties 


cnn, 
General | Global Exclusions 
© Do not use any extemal configuration file 


© Use settings from the shared location 
© Use settings from InstallShield Defaults 


© Use settings from a custom file 


| \\sch01 sevuganaxp\data\CabS cope\Acrobat Distiller 5.0.5\output\O ptions. ini 


Browse... 


Select one of the following options for the configuration file: 


Option Description 
Do not use any external Repackager will import all captured data into the Repackager project. 
configuration 


Use settings from the shared Repackager will use the settings contained in isrepackager.ini in the AdminStudio 


location shared directory (configured during installation). Use this option when you are working 
in a team environment where the exclusion list needs to be stored in a centralized 
location. 

Use settings from Repackager will use the settings contained in the default.ini file in the Repackager 

InstallShield defaults folder. These are the InstallShield-recommended exclusions. InstallShield recommends 


you do not modify these exclusions so you can return to them if you need to restart your 
exclusion list. 


Use settings from a custom Specify or browse to a file created with the Global Exclusions Editor that you want to 
file use as your filter during conversion to a Repackager project. You would create a custom 
exclusion file based upon your company's requirements. 
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Using the custom settings option, it is possible to use the local settings file (isrepackager.ini) in the Windows directory. 
This file is also used for default exclusions for the Repackaging Wizard. By modifying this file, you introduce the 
possibility of excluding data at repackaging time in subsequent Repackaging Wizard executions, as opposed to 
marking items as excluded in a Repackager project (which does not affect the captured data). For this reason, 
InstallShield highly recommends you do not use the isrepackager.ini configuration file in the local Windows folder for 
your Repackager global exclusions. 


WinINSTALL Conversion Dialog 


When you convert a WinINSTALL project to a Repackager project, this dialog box appears to allow you to set 
WinINSTALL-specific variables. These variables are: 


Variable Description 

@Server The machine name of the server where the WinINSTALL directory is located. 

@WinstallDir The location of the directory where the WinlINSTALL executables are located. 
Views 


Repackager includes several views, from which you can examine the captured data that will be used to create an 
InstallShield DevStudio project (ism) and Windows Installer package (.msi). Depending on the presence or absence 
of certain data types, some views may not be displayed. For example, if the setup does not include any INI files, the 
INI Files view will not be displayed in the View List. 


Information listed in the views (such as files, INI files, or registry entries) is limited to 267 characters in length. Anything 
longer than this limit will be truncated in the view. The full value can be viewed in DevStudio. 
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Captured Installation View 


From the Captured Installation View, you can review summary information about the setup you are converting into a 
Windows Installer package. 


PackageForTheWeb 4.irp - InstallShield Repackager 
Help 


Captured Installation Br Captured Installation 
- a Registry Entries E Summary 
(4g) Repackaged Output 
g Package Information Captured Installation Summary 


Advanced Settings 
Operating System: Windows XP, version 5.1.2600 Service Pack 1 (English) 


Path to original setup: C:\AdminStudio Shared\mplayer2.exe 


Original target folder: 


O files GE 2shortcuts 


@ 29 reaistry entries T$ OINI file entries 


Captured Installation Tasks 


=) Create setup capture report 
Generate an HTML or text document that summarizes the captured setup data. 


J) Scan for setup intent 
Analyze the captured setup data For missing files and files that the original setup intended to deploy. 


This view lists the operating system (including service pack) where capture was performed, the number of files 
captured, the number of INI file changes made, the number of registry entries captured, and the number of shortcuts 
captured. Each subview of this view allows you to view the names and associated information of each item captured, 
and selectively exclude (or reinclude) these items from the ultimate Windows Installer package. 


If no entries were captured of a particular type, the corresponding view does not appear in the View List. For 
example, if no INI file changes were captured, the INI File view is not displayed. 


From the Captured Installation view, you can also create a report or scan for setup intent. 


Additionally, you must specify the original target folder for the installation. In most cases, this will be a subdirectory 
of [ProgramFilesFolder]. Alternatively, you can enter your own target. This value will be set as the value for 
INSTALLDIR, and is a mandatory property. Information about the provided install locations can be found in the 
System Folder Properties topic of the Windows Installer online help. 


You can also perform some tasks from this view—creating a setup capture report, scanning for setup intent, and 
scanning InstallShield Professional media (if the original setup was created with InstallShield Professional) for 
additional files. 
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Files and Folders View 


From the Files and Folders view, you can examine information about each captured file, selectively exclude files or 
directories from the package you are creating, or reinclude files that you previously excluded. 


InstallShield@.irp - InstallShield Repackager DAR) 
File view Project Build Tools Help 


Captured Installation Files and Folders 
__] Files and Folders 


ay Registry Entries 
{Ey Shortcuts 

=. 3 Repackaged Output O files will be excluded. 
g Package Information 


Summary 


136 files were captured. 


Advanced Settings Exclude all Exclude Include Include all 


H- [ProgramFilesFolder] Name Size (bytes) Version Language Condition 
Ge [CommonFlesFolder] __]color Management Off.csF 563680 English 
5- Adobe B) Emulate Acrobat 4.csf 139438 English 


5 © as |_]Emulate Photoshop 4.csf 729048 English 
z a Europe Prepress Defaults.csf 563180 English 
© 


E TypeSpt o Japan Prepress Defaults.csf 563144 English 
© Acrobat 5.0 Photoshop 5 Default Spaces.csF 730900 English 
H- [SystemFolder] |_]US Prepress Defaults.csf 563132 English 
S- [AppDataFolder] [L] Web Graphics Defaults.csf 564604 English 


H-E [PersonalFolder] 


The upper pane displays the number of files captured and how many of these files will be excluded from the Windows 
Installer package when built. The lower-left pane provides a tree from which you can see where files will be installed 
and the names of the files. When you select a file from the tree, the lower-right pane displays attributes for that file. 
These attributes are: 


Attribute Description 

Name The file's name. 

Size The file's size in bytes. 

Version The file's version. 

Short Name The short name for the file (if the file's author defined it). 
Language The file's language. 


Excluding Files and Subdirectories 


To specify which files and subdirectories you want to include in the package, use the Exclude, Exclude All, Include, 
and Include All buttons: 


m To exclude a captured file from the package, select the file you want to exclude and click Exclude. 


m To exclude all captured files and subdirectories within a directory from the package, select the directory containing 
the files and subdirectories you want to exclude and click Exclude All. 
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m To include a captured file in the package that had previously been excluded, select the file you want to include and 
click Include. 


E To include all captured files and subdirectories within a directory, select the directory containing the files and 
subdirectories you want to include and click Include All. 


Registry Entries View 


From the Registry Entries view, you can examine information about each captured registry entry, selectively exclude 
registry values or registry keys from the package you are creating, or reinclude registry values that you previously 
excluded. 


InstallShield (R).irp - InstallShield Repackager 
File view Project Build Tools Help 


(OH t E epl 48 
WY Captured Installation ++ Registry Entries 
Files and Folders $ Summary 
Registry Entries 
IEJ Shortcuts 
= @ Repackaged Output Oregistry entries will be excluded. 
g Package Information 


Advanced Settings Exclude all 


E- HKEY_CURRENT_USER fone Type vale 
i=l Ss a) ad) Iswubble REG_BINARY 31 
= nstallShie! lab d" " 
= Wubble = REG_SZ Yes, I said "wubble’ 
ee Wubble =) ~ E 
B- HKEY_LOCAL_MACHINE 
B- Software 
B- InstallShield 
B-E sample 


£ 1.00.0000 


5 registry entries were captured. 


The upper pane displays the number of registry entries captured and how many of these entries will be excluded from 
the Windows Installer package when built. The lower-left pane provides a tree displaying the registry keys and subkeys 
captured. When you select a key from the tree, the lower-right pane displays any registry values for that key. Displayed 
information includes: 


Attribute Description 
Name The registry value name. 
Type The registry value type. This can be either a string value, an expandable string value, a multistring value, 


a dword value, or a binary value. 


Value The content of the registry value. 
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Excluding Registry Entries 


To specify which registry entries you want to include in the package, use the Exclude, Exclude All, Include, and 
Include All buttons: 


m To exclude a registry entry from the package, select the registry entry you want to exclude and click Exclude. 


m To exclude all registry entries and subdirectories within a directory from the package, select the directory 
containing the registry entries you want to exclude and click Exclude All. 


m To include a registry entry in the package that had previously been excluded, select the registry entry you want to 
include and click Include. 


m To include all registry entries and subdirectories within a directory, select the directory containing the shortcuts 
and subdirectories you want to include and click Include All. 


Shortcuts View 


From the Shortcuts view, you can examine information about each captured shortcut, selectively exclude shortcuts 
from the package you are creating, or reinclude shortcuts that you previously excluded. 


InstallShield®.irp - InstallShield Repackager 
File view Project Build Tools Help 


‘6H tte K | om 
=) gy Captured Installation Shortcuts 
|_] Files and Folders As ummary 
g Registry Entries 2 shortcuts were captured. 
(Ey Shortcuts 
B-A Repackaged Output 
g Package Information 


Advanced Settings Exclude all Exclude Include 


4 [ProgramMenuFolder] Attribute | Value 


laf Acrobat Distiller 5.0 Description Acrobat Distiller 5.0 
S- [StartupFolder] Command — [ProgramFilesFolder]Adobel\ Acrobat 5.0\Distillr\acrodist.exe 
E Acrobat Assistant Working Dir [ProgramFilesFolder]Adobe\ Acrobat 5,0\Distillr 
Icon File [ProgramFilesFolder Adobe} Acrobat 5. 0\Distillr\acradist.exe}, 
Icon Index 0 


0 shortcuts will be excluded. 


The upper pane displays the number of shortcuts captured and how many of these shortcuts will be excluded from 
the Windows Installer package when built. The lower-left pane provides a tree from which you can see where 
shortcuts will be installed and the names of the shortcuts. When you select a shortcut from the tree, the lower-right 
pane displays attributes for that shortcut. These attributes are: 


Attribute Description 
Description The name of the shortcut as it appears on the desktop. 
Command The fully-qualified path and name of the file to which the shortcut points. 
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Attribute Description 


Working Dir The shortcut's working directory, which may need to be specified so required files can load. This 
is equivalent of the Start in value found when right-clicking a shortcut from the desktop and 
selecting Properties. 


Icon File The name of the file containing the shortcut's icon. 
Icon Index The index number for the icon in the icon file. 
nN 
| }— 


Shortcuts can be excluded from the Windows Installer package you are building on an individual shortcut basis or by 
directory. 

Excluding Shortcuts 

To specify which shortcuts you want to include in the package, use the Exclude, Exclude All, and Include buttons: 


E To exclude a shortcut from the package, select the shortcut you want to exclude and click Exclude. 


m To exclude all shortcuts and subdirectories within a directory from the package, select the directory containing the 
shortcuts you want to exclude and click Exclude All. 


Em To include a shortcut in the package that had previously been excluded, select the shortcut you want to include 
and click Include. 
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INI Files View 


From the INI Files view, you can examine information about each captured INI file, selectively exclude INI files or 
INI file sections from the package you are creating, or reinclude INI files or sections that you previously excluded. 


Realplayer8.irp - InstallShield Repackager 
File Yiew Project Build Tools Help 
(@H|t+¥er\HX 

G Captured Installation INI file entries 
__] Files and Folders Summary 
@Y Registry Entries 


Sherkeuks 9 ini entries were captured, 
INI Files 0 ini entries will be excluded. 


=) cà Repackaged Output 


8 Package Information Exclude File Exclude Section Ini tior Include File 


Advanced Settings 


Hy %FavoritesFolder%\Links\RealPlayer.ul | Name Value 
S- %FavoritesFolder%|Media\Real.com Re (Š) IconFile — %ProgramFilesFolder%|RealiRealPlayeriRealPlay.exe 


a) ane o 


H- %FavoritesFolder%\RealPlayer Home P Ë) ure http://realquide.real.com/stations/ 


The upper pane displays the number of INI files captured and how many of these INI files will be excluded from the 
Windows Installer package when built. The lower-left pane provides a tree from which you can see the full path to 
captured INI files and sections contained within the INI files. When you select a section from the tree, the lower-right 
pane displays name/value pairs in that section. 


Deleted Files View 


From the Deleted Files view, you can examine information about each file deleted during repackaging, selectively 
exclude files or directories from the package you are creating, or reinclude previously excluded files. 


The upper pane displays the number of files captured and how many of these files will be excluded from the Windows 
Installer package when built. The lower-left pane provides a tree from which you can see where files will be installed 
and the names of the files. When you select a file from the tree, the lower-right pane displays attributes for that file. 
These attributes are: 


Attribute Description 

Name The file's name. 

Size The file's size in bytes. 

Version The file's version. 

Short Name The short name for the file (if the file's author defined it). 
Language The file's language. 
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Excluding Files and Subdirectories 


To specify which files and subdirectories you want to include in the package, use the Exclude, Exclude All, Include, 
and Include All buttons: 


To exclude a captured file from the package, select the file you want to exclude and click Exclude. 


To exclude all captured files and subdirectories within a directory from the package, select the directory containing 
the files and subdirectories you want to exclude and click Exclude All. 


To include a captured file in the package that had previously been excluded, select the file you want to include and 
click Include. 


To include all captured files and subdirectories within a directory, select the directory containing the files and 
subdirectories you want to include and click Include All. 


Deleted Registry Entries View 


From the Deleted Registry Entries view, you can examine information deleted from the registry repackaging, 
selectively exclude registry keys from the package you are creating, or reinclude previously excluded data. 


The upper pane displays the number of deleted registry entries captured and how many of these entries will be 
excluded from the Windows Installer package when built. The lower-left pane provides a tree displaying the registry 
keys and subkeys captured. When you select a key from the tree, the lower-right pane displays any registry values for 
that key. Displayed information includes: 


Attribute Description 
Name The registry value name. 
Type The registry value type. This can be either a string value, an expandable string value, a multistring 


value, a dword value, or a binary value. 


Value The content of the registry value. 


Excluding Registry Entries 


To specify which registry entries you want to include in the package, use the Exclude, Exclude All, Include, and 
Include All buttons: 


To exclude a registry entry from the package, select the registry entry you want to exclude and click Exclude. 


To exclude all registry entries and subdirectories within a directory from the package, select the directory 
containing the registry entries you want to exclude and click Exclude All. 


To include a registry entry in the package that had previously been excluded, select the registry entry you want to 
include and click Include. 


To include all registry entries and subdirectories within a directory, select the directory containing the shortcuts 
and subdirectories you want to include and click Include All. 
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Repackaged Output View 


From this view, you can configure build options for the project, including whether to build an MSI package 
automatically following conversion. 


Realplayer8.irp - InstallShield Repackager 


File view Project Build Tools Help 


BH tte 


Captured Installation 


Files and Folders 
Registry Entries 


DevStudio Project: 


$ Advanced Settings 


Windows Installer Package: 


| W:\repackager\templatelrealplayer\Realplayers.ism 


(not built) 


Repackaged Output Options 


Create a Windows Installer package (.msi) after creating the DevStudio project 


Build a compressed, single-file package that contains all of the files. 


[C] Create a Setup.exe to launch the package 


@ Use the default DevStudio template 


© Use a customized template 


aie 


CAP NUM 


The following properties are available for configuration: 


Option 


Description 


DevStudio project 


Provide the name and location of the InstallShield DevStudio project (.ism) file. 


Windows Installer package 


The name and location of the Windows Installer package (.msi) to build. 


Create a Windows Installer 
package after creating the 
DevStudio project 


If this option is selected, after creating the InstallShield DevStudio project file (.ism), an 
MSI will be built based on that project file. 


Build a compressed, single-file 
package that includes all of the 
files 


Select this option if you want to compress all necessary files inside the MSI package, 
as opposed to storing them outside of the MSI database. 


Create a Setup.exe to launch 
the package 


If you are building an MSI package automatically, check this option to create a 
Setup.exe file to begin the installation. 


Use the default DevStudio 
template 


When building the DevStudio project, select this option to use the default DevStudio 
template. 
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Option Description 
Use a customized template When building the DevStudio project, select this option to specify a custom template 
fo use. 


Once you have built the Windows Installer package and/or InstallShield DevStudio file, you can launch DevStudio 
from the Repackaged Output area of the view. 


Package Information View 


The Package Information view allows you to specify information for the Windows Installer package that you build 
from the Repackager project. Much of this information may be prepopulated based on settings used in the 
Repackaging Wizard. 


Realplayer8.irp - InstallShield Repackager 


Fie view Project Build Tools Help 


Captured Installation [E] package Information 
a Files and Folders VES summary 
Registry Entries 
Shortcuts Windows Installer Package 
a INI Files 
(4g) Repackaged Output 
SEE Company Name: | RealNetworks, Inc. 


Advanced Settings 


Product Name: | Realplayer 


Version: 8.0.9.432 


Product URL: http: www. mycompany.com 


Support URL: http://support.mycompany.com 


You can configure the following options: 


Property Description 

Company Name The name of the company that developed the product you are repackaging. 

Product Name The name of the product you are repackaging. 

Version The product's version number. 

Product URL The URL for product information. This appears in Add/Remove Programs in the Control Panel. 
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Property Description 


Support URL A URL for support information. This also appears in Add/Remove Programs in the Control Panel, 
and is often changed during repackaging to provide an internal support URL. 


Advanced Settings View 


From the Advanced Settings view, you can configure several additional settings that may apply to your repackaged 
setup. 


Realplayer8.irp - InstallShield Repackager 
File View Project Build Tools Help 


Captured Installation © $ Advanced Package Settings 
Files and Folders yet! Captured Data Conversion Settings 

3 Registry Entries 
Shortcuts Package Conversion 

a INI Files 

[=] EE] Repackaged Output 

g Package Information 

Advanced Settings Display only the Welcome dialog during installation. 


Use DevStudio path variables instead of physical source paths. 


Replace files with merge modules whenever possible, 
(Use the language captured by the Repackager as the language of the setup 


Include files From Setup Intent scan 


Component Settings 


Mark components destined for the System Folder as permanent. 
Mark components destined for the CommonFiles folder as shared. 
Map registry data to the appropriate COM tables. 

[C] Map registry data to the appropriate ODBC tables. 


[C] Map NT Service events to the ServiceControl table, 


InstallShield SmartScan Settings 


Include files From InstallShield legacy media scan 


C] Exactly match legacy setup's Operating System requirements 


Select the appropriate options: 


Option Description 


Package Conversion Settings 


Use DevStudio path variables When storing files in the DevStudio project (.ism), the Wizard uses path variable 
instead of physical source paths locations whenever possible. 
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Option 


Description 


Display only the Welcome dialog 
during installation 


Only the Welcome dialog is displayed when the Windows Installer package is 
run on a target machine. If this option is unchecked, the default DevStudio UI 
sequence is displayed when the setup is installed. 


Replace files with merge modules 
wherever possible 


Following best practice rules, AdminStudio replaces components with comparable 
merge modules whenever possible. 


Use the language captured by 
Repackager as the language of 
the setup 


When selected, the target package's language will be the language detected by 
Repackager (as displayed in the Captured Installation view). 


Include files from Setup Intent scan 


Any files identified when running the Setup Intent Wizard will be included in the 
package (unless you have manually excluded them from the project). 


Component Settings 


Mark components destined for the 
System folder as permanent 


Executable files installed to the system folder (System32Folder) are marked as 
Permanent files and will not be uninstalled when the package is uninstalled. This 
eliminates ICEO9 validation errors. 


Mark components destined for the 
Commorfiles folder as shared 


Executable files installed to the CommonFilesFolder (or a subfolder of 
CommorFilesFolder) are marked as shared files. This ensures that these 
components can coexist with DLLs installed by previous setups. 


Map registry data to the 
appropriate COM tables 


Setting this option reduces the number of ICE33 warnings that can occur during 
package validation, resulting from data not being mapped to the appropriate 
MSI tables. 


Map registry data to the 
appropriate ODBC tables 


If selected, ODBC-related registry data is mapped to ODBC tables instead of the 
Registry table. This data will only function correctly if Windows Installer supports 
the ODBC resource being mapped; InstallShield recommends you do not enable 
this option if you are unsure whether the ODBC resources are supported correctly 
by Windows Installer. 


Map NT Service events to the 
ServiceControl table 


If selected, NT Service-related registry data is mapped to ServiceControl table 
instead of the Registry table. 


InstallShield SmartScan Settings 


Include files from InstallShield 
Professional media scan 


Files identified in the Media Scan Wizard will be included in the package (unless 
you have manually excluded them from the project). 
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Option Description 


Exactly match legacy setup's For SmartScan projects or projects using the Professional Logging Method: 


Operating System requirements a Selected -— if this option is selected, component conditions will store specific 


operating system information: if the filter was NT4, the condition will be 
(VersionNT=4). 
=a Unselected—If this option is not selected, component conditions will store 


a grouping of the operating system: if the filter was NT4, the condition will be 
(VersionNT). 


= Default—By default, this option is not selected. 


Repackaging Wizard 


Repackager provides the Repackaging Wizard to convert a legacy setup into a Repackager project. Using this Wizard, 
you can select the repackaging method (either snapshot or installation monitoring), specify the setup(s) you want to 
repackage, and run the setup(s). When the Repackaging Wizard has finished its analysis, Repackager automatically 
creates a Repackager project (.irp) file, which can be modified in Repackager. You can then convert this file to an 
InstallShield DevStudio project (ism) for further editing, or convert it directly to a Windows Installer package (.msi). 


Welcome Panel 


The Welcome panel appears when you first launch the Repackaging Wizard, providing some introductory information 
about the use of the Wizard, including that it is for use with traditional (non-Windows Installer-based) installations. 


InstallShield Repackaging Wizard 
Welcome to InstallShield Repackaging Wizard 


This wizard enables you to create a completely new 
installation For an existing, packaged application, It can 
also create an installation project that can be Further 
enhanced using InstallShield DevStudio. 


should be run remotely From a mapped location, 
See the Help Library topic "Repackaging Wizard 
Best Practices" for details. 


i ) For optimal use, InstallShield Repackaging Wizard 


The Next button advances you to the Method Selection Panel. 
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From the Method Selection panel, select the method(s) you want to use for repackaging. 


InstallShield Repackaging Wizard 


Method Selection 
Select a repackaging method, 


On ' 
Repacker watches lower-level system activities and records related changes made to the 


system by the setup program(s), It then analyzes these activities and stores the setup 
data in an output file which can be converted into a Windows Installer package. 


O Snapshot 


Repackaging Wizard takes an initial snapshot of the local system, runs the setup 
program(s}, and then takes a second snapshot. The difference between the two 
snapshots is stored in an output file which can be converted into a Windows Installer 
package. 


The available choices include: 


Technology Description 

Installation The recommended repackaging technology for Windows XP, 2000, and NT 4 systems, install 

Monitoring monitoring watches all activities generated by an installation, and then determines the files, INI 
files, registry entries and shortcuts that should be included in the generated Windows Installer 
package. 


Installation Monitoring is significantly faster than the snapshot repackaging method, but only works 
on Windows XP, 2000, and NT 4 systems. 


Snapshot The snapshot method involves taking system snapshots before and after an installation, and then 
creating the Windows Installer package from the difference between them. Any configurations you 
make between snapshots is also included in the generated Windows Installer package. 


Although slower than Installation Monitoring, the snapshot method works on Windows 9x, NT 4, 
Me, 2000, and XP operating systems. 
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The InstallShield Professional Logging Method, which should be used to repackage InstallShield DevStudio 9.x 
InstallScript setups, is not offered as a choice on this panel. However, if you specify a DevStudio 9.x InstallScript setup 
on the Collect Product Information Panel (the next panel in the Repackaging Wizard), Repackager will automatically 
detect the DevStudio 9.x InstallScript setup and will display the InstallShield Professional Setup Panel, where you can 
choose to use the InstallShield Professional Logging Method instead of the Installation Monitoring or Snapshot methods. 
It does not matter which option you select on the Method Selection Panel, but if you select the Snapshot method and 
then select Multiple Steps on the Snapshot Method Panel (which appears next), Repackager will not recognize the setup 
as a DevStudio 9.x InstallScript setup and the InstallShield Professional Setup Panel will not appear. 


O 


Regardless of the repackaging method used, Repackager captures system changes made to the following: 


Application Paths 
Environment Variables 
Files 

INI Files 

NT Services 

ODBC Data Sources 
ODBC Drivers 

Printer Drivers 
Registry Entries 
Shortcuts 


If you are using the InstallShield Professional Logging Method to repackage an InstallShield DevStudio 9.x InstallScript 
setup, the following additional information is also collected: 


Path Variables 
Feature/Component Tree 
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The Snapshot Method Panel, which is only displayed if you use the snapshot technology, allows you to specify the 
way in which you perform repackaging. 


InstallShield Repackaging Wizard 


Snapshot Method 
Select either a single-step or multiple-step snapshot method, 


In a single pass, automatically analyze the initial system status first, run one or 
more setup programs (to modify the local system), and then analyze the 
system status changes. 


Prompt before running the setup program(s) 


© Multiple Steps (Classic Style) 


On the Snapshot Method Panel, you have the folowing two options: 


Option Description 


Single Step Repackaging in a single step requires you specify at least one setup program to repackage. The 
Repackager first takes an initial system snapshot, then runs the setup program(s) you specify, and 
then takes a second snapshot to create the script file that can be converted into a Windows Installer 
package. 


You also have the option of requiring the Repackager to prompt you before running the setup 
program(s), allowing you the opportunity to make changes to your system that you want included in 
the final package. 


[pana 


f 


If you are repackaging an InstallShield DevStudio 9.x InstallScript setup and want to use the 
InstallShield Professional Logging Method, select Single Step. 


Multiple Steps Repackaging in multiple steps allows you to run the Repackager fo obtain an initial system snapshot, 
after which the Repackager exits. You can then perform any modifications to the system, such as 
changing configurations, running installations, and so forth. After making the necessary 
modifications, run the Repackager again to analyze system status changes. The difference between 
the second Repackager execution and the first results in the script file that ultimately can be 
converted into a Windows Installer package. 


The single step method is very straightforward if you are repackaging applications and not performing many system 
changes. The multiple step method allows greater flexibility because a setup is not required. This allows you to capture 
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system configurations within the Repackager output, and ultimately within a Windows Installer package. For example, 
you could modify the screen color depth and create an MSI package for just that configuration. 


If Single Step is selected, the Collect Product Information Panel is displayed when you click Next. If Multiple Steps is 
selected and you are performing the initial snapshot, the Collect Product Information panel is displayed, but the Setup 
Programs area is disabled. If you are performing a system status change analysis, the Repackaging Panel appears when 
you click Next. 


Collect Product Information Panel 
The Collect Product Information panel gathers information necessary for repackaging the installation(s). 


InstallShield Repackaging Wizard 


Collect Product Information 
Provide product information for repackaging. Items with asterisks (*) are 
required, 


Setup Programs 


*Program File: [ E 


Command-line 
Argument(s): 


Edit Setup List 
Product Information 
*Product Name: | PackageForTheWeb 4 Version: | 4.0.0 
Product URL: | http://www installshield. | Support URL: | http://www. installshield. 


Company Name: | InstallShield Software Corporation g 


The information on the Collect Product Information Panel is divided into two sections: Setup Programs and Product 
Information. 


Setup Programs 


The Setup Programs area contains information about the setup you are repackaging. Repackager uses this information 
to launch the setup correctly following pre-analysis. The information collected includes: 


Field Description 


Program File The name and location of the setup executable. Click the Browse button (...) to locate this file. 
This is a required field. 


Command-Line Any command-line arguments to be used when the setup is run. 
Argumenit(s) 
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Field 


Description 


Edit Setup List 


Click to display the Additional Setup Programs Dialog, from which you can enter additional 
installations to repackage together with this installation. Additional setups share the same 
product name, version number, and company name in the repackaged installation. However, 
as you locate each additional setup to repackage, you can specify command-line parameters 
pertaining only to that setup. You can also specify the order in which the installations are run, 
should it be necessary. 


If you are repackaging an InstallShield DevStudio 9.x InstallScript setup and want to use the 
InstallShield Professional Logging Method, specify only one Program File. If you specify multiple 
setup program files, the InstallShield Professional Setup Panel will not appear, and the 
Repackaging method that you chose on the Method Selection Panel will be used instead. 


Field 


Description 


Product Name 


Enter the name for final repackaged installation. This could be the name of the original installation 
(for example, Tuner), the name of a collective group of products (for example, InstallShield 
Applications), or another name of your selection (for example, My Apps). This is a required field. 


Version Number 


Enter the version of the product. 


Product URL 


Enter the URL for product information. 


Support URL 


Enter the URL for support information. 


Company Name 


Enter the name of the company. 


Install Directory 


Provide the destination for the installation. You can use Windows Installer folder names from the 
drop-down list as a starting point, and then append the rest of the installation location, or you can 
hard-code the directory path. 


Clicking Next advances you to the Set Target Product Information Panel. 
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This panel appears in the Repackaging Wizard if you specified an InstallShield DevStudio 9.x InstallScript setup in the 
Program File field of the Collection Product Information Panel, and if: 


m You specified only one program file on the Collection Product Information Panel, AND 
m You selected the Installation Monitoring method on the Method Selection Panel, OR 


m You selected the Snapshot method on the Method Selection Panel and then selected Single Step on the Snapshot 
Method Panel. 


InstallShield Repackaging Wizard 


InstallShield Professional Setup 
Optionally change repackaging method for ISPro setup 


The setup you are launching was created with InstallShield Professional. The AdminStudio 
Repackager can directly read logged output of InstallShield Professional Engine operations, 
removing the need for repackaging InstallShield Professional setups. 


It is recommended that you use this method instead of repackaging. 


If you want to use the InstallShield Professional Logging Method, select the Use InstallShield Professional Logging 
instead of repackaging checkbox. 


Using the InstallShield Professional Logging Method, Repackager can read logged output of InstallShield DevStudio 
9.x InstallScript setups. This method replaces the other repackaging methods (Installation Monitoring and Snapshot) 
for DevStudio 9.x InstallScript setups. By using this method, you will be able to get additional information from the 
Professional setup that would not be captured by repackaging, including path variables and a feature tree. For more 

information, see InstallShield Professional Logging Method. 


Click Next to proceed to the Set Target Information and Capture Settings Panel. 
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Set Target Project Information and Capture Settings Panel 


The location where you want files created by Repackager stored is defined in the Set Target Project Information 
panel. 


InstallShield Repackaging Wizard 


Set Target Project Information and Capture Settings 
Provide the target project path and review capture settings. 


Specify the location where Repackaging Wizard will store files created during system change 
analysis. The Repackaging Wizard output file (inc) will be saved to this location, 


Project path to store files 
Cc: \Packages\PackageForTheWeb | Les 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis, 


InstallShield recommends that this location not be located on your clean machine, but rather on the same machine as 
the Repackager executable (most likely on your administrator machine). 


You can also review or edit current capture settings by clicking Edit, which displays the Analysis Options Dialog. 


Click Start to begin repackaging and display the Repackaging Panel. 
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Repackaging Panel 


The Repackaging panel appears while Repackager analyzes your system. 


InstallShield Repackaging Wizard 


Repackaging ... 
Please wait while InstallShield Repackaging Wizard performs system analysis, 


InstallShield Repackaging Wizard is analyzing your system and setup(s) ... 


Analyzing the system state changes... 


Depending on settings configured before starting repackaging, the analysis may stop following the initial phase, and 
again after setup has been run. 


Following repackaging, the Summary Panel is displayed. 
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Summary Panel 


The final panel displayed by Repackager is the Summary panel. 


InstallShield Repackaging Wizard 


Summary 
Review the summary information below, Click Finish to exit Repackaging 
Wizard, 


Summary: 

Repackaging Method: InstallShield Pro Log File 

Setup 1: C:\AdminStudio Shared\ProRepackage\sample\Media\Release 
1\Disk Images\Disk1\setup.exe 

Product Name: InstallShield (R) 
Output Files: 

Output file created: C:\Packages\PackageForTheWeb44\InstallShield (R}.inc 
Next Steps: 


Click Finish to launch the Repackager to edit and build your project. 


This panel provides confirmation that repackaging was successful, and provides the location of the source setup 
program(s), the Windows Installer package, and the DevStudio project. 
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Additional Repackaging Wizard Dialogs 


The following dialogs can be accessed from the Repackaging Wizard. 


Additional Setup Programs Dialog 


This dialog, which is accessed by clicking the Edit Setup List button on the Collect Product Information Panel of the 
Repackaging Wizard, displays a list of additional setup programs you want to add to the final Windows Installer 
package. 


Additional Setup Programs 


Specify the setup programs you want to repackage. InstallShield Repackaging 
Wizard will package them into a single MSI package. 


Setup Program Command-line Argur 


C:\AdminStudio Shared\mplayer2.exe 
C:\AdminStudio Shared\MSACCESS.... 


toma 


Essentially, this is a list of the other executables to run, in the order they are to be run, prior to final analysis. The 
following buttons are available: 


Button Description 

New Brings up the Setup Information Dialog to enter information about the setup programs. 

Edit Displays the Setup Information Dialog to edit information about the currently selected setup. 
Delete Removes the currently selected setup. 

Up Moves the selected setup up in the setup programs list. 

Down Moves the selected setup up in the setup programs list. 
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The Setup Information dialog allows you to enter or edit information pertaining to the installations you are 
repackaging. Accessible from the Additional Setup Programs Dialog, you can provide the name and location of an 
additional setup program, and any command-line arguments for the setup. 


Setup Information 


Modify the setup location and its command-line arguments, 


Program File: a3 


Command-line Argument(s): 


Analysis Options Dialog 


The Analysis Options dialog, accessible by clicking Edit from the Set Target Project Information and Capture Settings 
Panel, allows you to specify capture types for the repackaging session. 


Analysis Options 


Capture types 
Shortcuts 
eleted files Registry data 
INI files [C] Deleted registry data 


C] Non-.ini extensions 


Restrict directory analysis to the following (Snapshot mode only): 


You can select the following: 


Files 

Deleted files 

INI files 

INI files with non-.ini extensions 
Shortcuts 

Registry data 

Deleted registry data 


Additionally, for snapshot-mode captures, you can restrict directory analysis to specific directories, which can 
significantly improve repackaging performance. Click New to add a directory restriction, edit to modify an existing 
restriction, or delete to remove a restriction. 
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Options set in this dialog apply to the current and subsequent repackaging sessions. 


Command-Line Options 


The following command-line options are supported by the Repackaging Wizard: 


Option 


Description 


-? 


Displays a dialog containing usage information for all options. 


-app <setup program list> 


Allows you to provide a pipe (|) delimited list of setups to run during repackaging. 
You can also pass command-line arguments to the setup by separating them from 
the setup name with a semicolon (-app 

exe l;cmdline1 | exe2;cmdline2 | ...exeN;cmdlineN). 


-b [<project file path and 
name>.ism] 


Specifies the build/release destination folder. If <project file path and name> is 
not specified, Repackager uses the folder where the .inc file is stored. The project 
name must end in .ism. 


-cf <config.ini> 


This option allows you to select your own configuration template containing global 
exclusions. A sample of this type of file (named Default.ini) can be found in the 
<AdminStudio Directory>\<Version Number>Repackager directory. This particular 
file contains the default exclusion information from InstallShield. 


-cs <configuration type> 


This option allows you to select the configuration file type for global exclusions. 
Possible values are: 

= Local—Use local settings. 

= Shared—Use shared settings from the Share Point. 

= Default—Use the InstallShield Default settings stored in default.ini. 


= Custom-— Use a custom configuration file (in conjunction with -cf). 


-installdir <destination folder> 


Allows you to set the default value for the Original Setup Installation Location 
property in the Legacy Setup Conversion Wizard's Conversion Options panel. If 
Repackager can determine the installation directory, it automatically uses the value 
it determines and ignores this command-line argument. 


-mode <snapshot mode> 


Repackager supports the following repackaging modes for snapshots: 


a single—Single step repackaging that creates an INC file as its output. 

= ~=pre—Pre-scanning only scans the local drive for a baseline snapshot of the 
system. 

= ~post—Post-scanning only scans the local drive and compares the result with 
the pre-scan. The differences are written to the INC file as output. 


-mm Instructs Repackager to use installation monitoring as the repackaging technology. 

-mp Instructs Repackager to use the InstallShield Professional Logging Method as the 
repackaging technology. 

-ms Instructs Repackager to use snapshots as the repackaging technology. 
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Option Description 


-o <.ine path name> Specifies a folder path not including the filename. The file name is derived from 
the Product Name unless overridden with the -of switch. 


-of <inc file name> Specifies the .inc file name that should be used instead of the product name. Use - 
o to specify the path. 


-pc <company name> Allows you to set the company name. 


-pp <product name> Allows you to set the product name. This will be the same name as the generated 
Repackager output file (.inc). 


-pv <product version> Allows you to set the product version. 


-sb This option allows you to run Repackager silently, with no user interaction. A 
progress dialog is displayed. If no INI file is specified using the -i parameter, 
Repackager uses isrepackager.ini as the default input file. If an output folder is not 
specified using -o, the default output folder is C:\Packages. 


-sn This option allows you to run Repackager silently, with no user interaction and no 
progress dialog. If no INI file is specified using the -i parameter, Repackager uses 
isrepackager.ini as the default input file. If an output folder is not specified using - 
o, the default output folder is C:\Packages. 


-version This option displays standard version information for Repackager, including the 
full version and copyright information. 


In addition to the - sign for command-line arguments, you can also use the / symbol. 


Reboot Handling in the Repackaging Wizard 


During repackaging, a setup may require a reboot. For example, some operations may require a file which is in use be 
replaced, which can only be done after a reboot. Some nuances exist depending on the repackaging technology you 
are using (snapshot or installation monitoring). In either case, when the Repackaging Wizard detects that a reboot is 
necessary, the Repackaging Wizard saves the appropriate data and waits until you confirm that you are ready to reboot 
the machine. 


For snapshot repackaging, the operating system completes the reboot operation. During startup, the operating system 
restarts all applications and processes and performs any pending file operations. One of the applications that restarts 
is Repackager. Before you continue processing in Repackager, be patient and ensure all processes and applications 
have restarted. This may take a minute or two. After the applications and processes have been launched, you can 
continue repackaging by clicking Process. 


For installation monitoring, on reboot the operating system launches the Repackaging Wizard, which in turn launches 
applications and processes and waits until these are finished before prompting you to continue repackaging. However, 
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in some cases the processes or applications launched by the Repackaging Wizard will launch other applications and 
processes. As in snapshot repackaging, it is generally a good idea to wait a minute or two before clicking Process. 


In both circumstances, waiting helps ensure the setup is fully installed and that captured data contains the necessary 
information to properly rebuild the setup as an MSI installation. 


InstallShield SmartScan Wizard 


The InstallShield SmartScan Wizard is designed to scan original, InstallShield Professional 5.x and later media for 
setup information that may not have been captured during repackaging, such as possible additional files, INI files, 
shortcuts, or registry data (such as for language-specific setups or platform-specific setups). This primarily involves 
OS-dependent and language-dependent files that may be included in header files. Ultimately, this makes the 
installation more portable. 


Any files found will be displayed in Repackager in a different color (as specified in the Color tab of the Options 


dialog). 


The SmartScan Wizard is also able to group files, shortcuts and registry entries into features corresponding to 
InstallShield Professional components. Any items (files, folders, shortcuts, or registry entries) that are attached to a 
component directly or indirectly (through File Groups), are attached to their corresponding features. 


Automatic Launch of the SmartScan Wizard 


For your convenience, if a Repackaging project is opened (either by using Open on the File menu or by using the 
Repackaging Wizard), and the project meets certain conditions, the SmartScan Wizard is automatically launched. The 
SmartScan Wizard is launched: 


m if the original setup was an InstallShield Professional 5.5+ setup, AND 


m the file has not already been repackaged using the InstallShield Professional Logging Method (available for 
InstallShield DevStudio 9.x InstallScript setups only), AND 


E the InstallShield SmartScan Wizard has not already been run on this project 
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Welcome to the SmartScan Wizard Panel 
The first panel in the InstallShield SmartScan Wizard is the Welcome panel. 


InstallShield SmartScan Wizard 


Welcome to the InstallShield 
SmartScan Wizard 


This wizard will scan the original media for setup 
information that was not captured on the original target 
system but might be applicable on other operating 
systems or languages, so that your new setup can be 
more portable. 


Before continuing, make sure that you have set the 
Original Target Folder in the Captured Installation View. 


Click Next to continue. 


When you click Next, you advance to the Original InstallShield Professional Setup Panel, where you specify the 
InstallShield Professional setup you want to scan. 


For your convenience, if a Repackaging project is opened (either by using Open on the File menu or by using the 
Repackaging Wizard), and the project meets certain conditions, the SmartScan Wizard is automatically launched. The 
SmartScan Wizard is launched: 


if the original setup was an InstallShield Professional 5.5+ setup, AND 


the file has not already been repackaged using the InstallShield Professional Logging Method (available for InstallShield 
DevStudio 9.x InstallScript setups only), AND 


the InstallShield SmartScan Wizard has not already been run on this project 
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Original InstallShield Professional Setup Panel 


The Specify the path of the original setup executable field is filled in by default if that information exists. Click Browse 
to specify the InstallShield Professional setup executable that you want to scan. If you enter an invalid pathname, the 
Next button will be disabled. Specify a password, if required. 


Scan InstallShield Professional Media 


Original InstallShield Professional Setup 
Specify original Pro setup and password 


Specify the path of the original setup executable. 


C:\AdminStudio Shared\ProRepackage\sample\Media\Release 14 Browse... 


Specify password if required. 


[canes J mre 


Click Next to proceed to the Scanning Panel, which shows the output and progress of the scan. 


e 
Scanning 
This panel displays the progress that SmartScan Wizard is making as it scans an InstallShield Professional setup. 
Scan InstallShield Professional Media 


Scanning 
Scanning InstallShield Professional Setup for data to add 


Scanning InstallShield Professional Setup... 


Done 


Cancel Help i 


Click Next to proceed to the Setup Feature Tree Panel. 
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Setup Feature Tree Panel 


The Setup Feature Tree Panel lists the features and components that were configured in the original InstallShield 
Professional project. If you want to use this feature and component information, select the Add feature tree option. 


Scan InstallShield Professional Media 


Setup Feature Tree 
Choose to add feature information 


The setup information can be partitioned into the following features. 


DefaultFeature 


Click Next to proceed to the Scanning Media Panel, which first scans the original media, then displays the results. 


Following the actual scan of the original setup media, the SmartScan Wizard displays a log of files to be included in 
the project. 


Scan InstallShield Professional Media 


Scanning Media 
Searching for extra setup information in the media 


Wednesday, January 07, 2004 10:30:344M 

Scanning InstallShield Professional setup: C:\AdminStudio Shared\ProRepackage\sample\M 
Script-defined data that cannot be added to the project will be highlighted in red. 

File: [INSTALLDIR]\NOTEPAD.EXE 

File: (INSTALLDIR]\Prairie Wind. bmp 

File: (INSTALLDIR]\Santa Fe Stucco.bmp 

File: <DISK1TARGET> Slayout.bin 

File: <DISK1 TARGET > \datal hdr 

File: <DISKITARGET> \datal.cab 

File: <DISKITARGET>\setup.exe 

File: <DISK1 TARGET >\setup.inx 

File: <DISK1TARGET> \setup. ini 

Shortcut: [DesktopFolder]\Notepad Shortcut Target file: INSTALLDIR]SNOTEPAD.EXE 
Registry entry: [HKE'Y_CURRENT_USER Software] Value: @= 


TIVES CHIMMCRIT LCC Wt... abe beat) Sohan 7S 


< Í | 


Click Finish to add these to the project. Any default exclusions based on the global exclusions file will be applied. 
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Setup Intent Wizard 


Although an installation may have intended to install certain files, these files sometimes may not be installed—often 
because the files already exist on the target machine (either as the same version or a newer version). These files, 
although not installed or updated, are needed for the product to execute properly when the setup is run on a system 
that does not already have these files. The Setup Intent Wizard allows you to scan a setup to identify files that may not 
have been captured during repackaging—effectively recognizing the installation's intent for these files. 


Any files found will be displayed in Repackager in a different color (as specified in the Color tab of the Options 
dialog). 


Welcome Panel 


The first panel in the Setup Intent Wizard informs you the purpose of the Wizard, and warns you the source files for 
your project must be present for successful scanning. 


Setup Intent Wizard 


Welcome to the Setup Intent Wizard 


This wizard will scan the project for dependency files 
that were not installed by the original setup but must be 
installed in order for the application to execute 
properly. 


The source files for your project must exist in order for 
this scan to succeed. 


Click Next to continue. 


Click Next to start the scan and display the Scanning Project Panel. 
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The Scanning Project Panel is displayed while scanning is in progress. Each file scanned is listed, and a progress bar 
displays the overall scan progress. 


Setup Intent 


Scanning Project 
The project is being scanned. 


Scanning... 


File: schl sevuganaxp\data\CabS cope‘ Acrobat Distiller 5.0.5'output\ProgramFilesF olde 


Cea] (ae) 


When the scan is complete, the Results Panel opens, listing new files that your setup required. 


The final panel in the Setup Intent Wizard allows you to view and select new files detected by the Wizard, but not 
already included in your Repackaging project. 


Setup Intent 


Results 
New files that your setup requires have been discovered. 


Select the files to add to your project, then click Finish. 


.\ProgramFilesFolder\Adobe'Acrobat 5.0\Distillr\CoolT ype. dll 


Select the files you want to include in your project which were not identified during repackaging. 
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Click Finish to exit the Setup Intent Wizard and return to the Repackaging project (with selected files automatically 
added to the project), or click Back to return to the Scanning Project Panel. 


VMware Repackaging Wizard 


Repackager includes integration with VMware Workstation's virtual machine technology. This provides you with the 
ability to launch a VMware session for repackaging purposes, and run different operating systems on the same 
computer. By using VMware, you are able to forego the traditional "ghosting" for clean images each time a new 
application is repackaged by simply electing not to save changes to the VMware session. You can then reload the clean 
state of the operating system, and proceed to the next package. 


AdminStudio supports VMWare 3.0 and higher. 


Using the VMware Repackaging Wizard, you select an available VMware operating system, and then Repackager 
automatically launches the selected operating system within a VMware session. 


Welcome Panel 


The first panel displayed in the VMware Repackaging Wizard is the Welcome panel. It explains the purpose of this 
Wizard: to display available VMware images on the current workstation, allowing you to select and launch the one you 
need. 


VMware Repackaging Wizard 


Welcome to VMware Repackaging 
Wizard 


This wizard will display the available ¥Mware™ 
Guest Operating System images on this machine 
and allows you to choose and launch a VMware 
image to Repackage an application. 


Click Next to Continue 


Click Next to proceed to the VMware Virtual Machines Panel. 
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VMware Virtual Machines Panel 


On the VMware Virtual Machines panel, you select a VMware virtual machine available on the current workstation. 
Repackager automatically launches the selected virtual machine operating system within a VMware session so that you 
can begin repackaging in that environment. 


VMware Repackaging Wizard 


VMware Virtual Machines 
Select a VMware Virtual Machine to Repackage 


The following list contains all of the available YMware virtual machines. 


Please select a virtual machine and click Launch to begin. 


Japanese Windows XP Professional 
Japanese Windows XP Professional 


Windows 2000 Professional SP4 RP 
Windows 98 SE 

Windows NT4 Workstation SPBa IES5SP2 
Windows XP Professional SP2[Beta 


AdminStudio supports VMWare 3.0 and higher. 


Click Back to return to the Welcome Panel; click Launch to launch the selected VMware image. 
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° e © me 
Options.ini File 
The Options.ini file is created by Repackager and is used during the conversion of Repackager output into an 


InstallShield Developer project (ism). It includes basic project settings which are required by the Legacy Setup 
Conversion Wizard. 


Although many of these settings have a one-to-one correspondence with settings available in the Repackager interface, 
some can only be accessed by editing this INI file directly. 


Options.ini File Example 


[MMExclusions] 


[General] 

UseSrcFolder=Y 
EnablePathVariables=Y 
UseHKCUProxy=N 

Limi tedUI=Y 
SISAuthor=Instal]lShield Repackager 
OtherFi ]esNewComponents=N 
UseMergeModu les=Y 
SharedcommonFi les=Y 
PermanentSystemF7i les=Y 
PermanentSystemFi lesSubfolders=N 
Ext raHKCRPermanent=Y 
COMMapping=Y 
ServiceControlEvents=N 
ALLUSERS=Y 

ProjectTemplate= 

Bui |dCompressed=Y 
CreateSetupExe=N 
MultiUserShortcuts=Y 


[IgnoreShortcuts] 
TargetExel=isuninst.exe 
TargetExe2=uninst.exe 
TargetExe3=setup.exe 
TargetExe4=uninst.d11 


MMExclusions Section 


This section lists the merge module GUIDs that should not be included in your package. This section only applies if 
you have selected to replace files with merge modules during conversion. 
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General Section 


Following are descriptions of properties that can be set in the [General] section of the Options.ini file. 


Option Description 


AddIMMSearchPath Use to specify additional directories containing custom merge modules to use 
during repackaging. 


ALLUSERS If this option is set to "Y" and if the template file (specified using the 
Projectfemplate option) does not contain ALLUSERS in its Property table, then a 
property named ALLUSERS with a value of 2 will be added to the Property table. 
This will cause silent installs to behave as non-silent installs do (non-silent installs 
rely on a custom action to set this property). 


This option is set to "Y" by default. 


ARPPublisher This populates the Publisher field in Add/Remove Programs in the Control Panel. 

ARPPublisherURL This populates the Publisher URL field in Add/Remove Programs in the Control 
Panel. 

ARPSupportURL This populates the Support URL field in Add/Remove Programs in the Control 
Panel. 

AutoUpgrade Upgrades the DevStudio template project file (if used) if needed. 


This option is set to "Y" by default. 


BuildCompressed This option, set to "Y" by default, compresses all necessary files inside the MSI 
package, as opposed to storing them outside of the MSI database. 


BuildFeatures If the InstallShield SmartScan Wizard is specified to include feature information 
in this project, this option will be set to "Y". 


This option is set to "Y" by default. 


BuildMSI Specifies whether or not fo build the MSI package after building ISM. 
This option is set to "Y" by default. 


BuildProduct Identities the DevStudio Product configuration to build. 


BuildProScannedFiles Files identitied in the Media Scan Wizard will be included in the package (unless 
you have manually excluded them from the project). 


This option is set to "Y" by default. 


BuildRelease Identifies which DevStudio Release configuration to build. 


BuildStaticScannedFiles Any files identified when running the Setup Intent Wizard will be included in the 
package (unless you have manually excluded them from the project). 


This option is set to "Y" by default. 
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Option Description 

COMMapping When this option is set to "Y," registry data pertaining to COM information will 
be mapped to the appropriate MSI tables whenever possible. This reduces the 
number of ICE33 warnings that can occur during package validation. 

This option is set to "Y" by default. 

CreateSetupExe This option, which is set to "N" by default, allows you to automatically create a 
Setup.exe file to begin the installation. 

EnablePathVariables Set this option to "Y" to use path variables. If enabled, the repackaged setup is 
significantly more portable between computers (with dependencies to the system 
where the setup was repackaged removed). 

This option is set to "Y" by default. 

ExtraHKCRPermanent When this option is set to "Y," any changes made to existing registry data during 
repackaging which cannot be identified as belonging to a file installed by the 
setup are placed in permanent components, which are not removed by default 
when the repackaged setup is uninstalled. This prevents inadvertently removing 
registry entries required by other applications that were not originally made by 
the repackaged setup. 

By default, this option is set to "Y," and InstallShield strongly recommends 
retaining this setting to prevent unexpected results when the package is 
uninstalled. 

INSTALLDIR This value will be used for INSTALLDIR (the installation directory) and can use a 
Windows Installer property such as [ProgramFilesFolder]\MyProgram. 

ISProSetup If one of the original setups that was repackaged was created by InstallShield 
Professional 5.5 or later, this option will be set fo "Y". 

This option is set to "N" by default. 

LimitedUI Set this option to "Y" display only the InstallWelcome dialog when the MSI 
package is run. 

This option is set to "Y" by default. 

MultiUserShortcuts When this option is set to "Y," non-advertised shortcuts will work for all users on 
the target system. This will generate ICE43 warnings when validation is run. If 
you know the installation is for a single-user environment, change this option to 
"N" to avoid these warnings. 

This option is set to "Y" by default. 

MMPathVersion When including merge modules, if this option is set to "Y", compare path and 
version information. 

This option is set to "Y" by default. 

NewinstallDir Value for INSTALLDIR variable. 
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Option 


Description 


ODBCMapping 


If selected, ODBC-related registry data is mapped to ODBC tables instead of the 

Registry table. This data will only function correctly if Windows Installer supports 

the ODBC resource being mapped; InstallShield recommends you do not enable 

this option if you are unsure whether the ODBC resources are supported correctly 
by Windows Installer. 


This option is set to "N" by default. 


OSGranular 


For SmartScanned or ProLogged Projects: If this is set to "Y", component 
conditions will store specific operating system information. For example, if the 
filter was NT4, the condition will be (VersionNT=4). If this is set to "N", 
component conditions will store a grouping of the operating system. For 
example, if the filter were NT4, the condition will be (VersionNT). 


This is set to "N" by default. 


OtherComponentFileExtensions 


Specify additional extensions to use when defining components. MSI has rules 
governing component creation for file types. For example, PE files must have 
separate components. Therefore, certain extensions have been defined (EXE, DLL, 
etc.). Additional extensions can be defined in the options. ini file in the format of: 
Typel:Extension1|Type2:Extension2 


where Type is one of the following numbers: 


O = other 
1=PE 

2 = help 
3 = font 

4=INI 


This option is set to 1:QTX|1:AX by default. 


OtherFilesNewComponents 


When this option is set to "Y," one component will be created for every file in 
your setup. Otherwise, new components will only be created for each portable 
executable file. 


This option is set to "N" by default. 


PermanentSystemFiles 


Set this option to "Y" to mark portable executable files installed to a system folder 
(System32Folder) as Permanent files (will not be uninstalled). 


This option is set to "Y" by default. 


PermanentSystemFilesSubfolders 


Set this option to "Y" to mark files installed to a subfolder of a system folder as 
Permanent files (will not be uninstalled). 


This option is set to "N" by default. 


ProductName The name of the product. You must provide a value for this option either in this 
file or via the Legacy Setup Conversion Wizard. 

ProductVersion The version of the product. You must provide a value for this option either in this 
file or via the Legacy Setup Conversion Wizard. 

Project Name of DevStudio project file. 
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Option Description 

ProjectTemplate The name and location of the default InstallShield DevStudio project template 
(.ism) used in the conversion process. 

ServiceControlEvents When this option is set to "Y," the ServiceControl table will be populated for NT 


Services. 


This option is set to "N" by default. 


SharedCommor files 


Set this option to "Y" to mark portable executable files installed to the 
CommorFilesFolder (or subfolder) as Shared files. 


This option is set to "Y" by default. 


SiSAuthor 


This option populates the Author field of the Summary Information Stream 
(accessible from the package's properties). 


This option is set to "InstallShield Repackager" by default. 


SISSubject 


This option populates the Subject field of the Summary Information Stream 
(accessible from the package's properties). 


SkipMMIfShortcut 


Merge Modules that have files pointed to by shortcuts should be skipped even if 
they are not in the exclusion list. 


This option is set to "Y" by default. 


SmartScannedOnce 


Specifies whether or not the InstallShield SmartScan Wizard was run for this 
project. 


This option is set to "N" by default. 


UseAdvertisedShortcuts 


Create advertised shortcuts where applicable. 


This option is set to "Y" by default. 


UseHKCUProxy 


Set this option to "Y" to copy all registry entries in HKEY_CURRENT_USER to 
HKEY_USERS\.default. This will make the entries (and the application) available 
to all user accounts created after the Windows Installer package is installed. 


This option is set to "N" by default. 


UseLanguage 


When selected, the target package's language will be the language detected by 
Repackager (as displayed in the Captured Installation view). 


This option is set to "N" by default. 


UseMergeModules 


Set this option to "Y" to replace files with merge modules whenever possible 
during conversion. Exceptions are listed under the [MMExclusions] section. 


This option is set to "Y" by default. 


UseSrcFolder 


Set this option to "Y" to make the DevStudio project (.ism) folder default to the 
Repackager output project (.inc) folder. 


This option is set to "Y" by default. 
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Shortcuts that refer to executables listed in this section will be ignored during conversion. 


Files Associated with Repackager 


Several files are associated with Repackager. Some are output files, and some contain default information for 
Repackager to function. These files are described in the tables below. 


Files Used By the Repackaging Wizard 


File Location Description 
isrepackager.ini <Windows> directory This is an input file for the 
Repackaging Wizard. It contains 
If the file is not found in the <Windows> directory, a list of the exclusions for the files, 
then the Repackaging Wizard extracts a default file folders, .ini files and registry 
from the resource and stores it in the <Windows> entries for the last used 
directory. configuration of Repackager. 
During the Snapshot and Install 
Monitoring modes of 
repackaging, the entries in this file 
are filtered out from the 
repackaged output. 
Options.ini Repackager output directory (specified in the Set This is an output file from the 
Target Project Information and Capture Settings Repackaging Wizard. It contains 
Panel). configuration information about 
the repackaged setup, including 
The Repackaging Wizard makes a copy of the whether to use path variables, 
default options.ini that is present in the <AdminStudio whether to display a limited user 
Directory>\<Version Number>\Repackager interface during installation of the 
directory and saves this file in the same location as repackaged setup and whether 
the current repackaged output file (.inc). every file will go into its own 
Additionally, the UseSrcFolder flag can be used to component. 
store the created DevStudio file in the same directory 
as the .inc file. 
<productname>.inc Created in the Repackager output directory (specified This is an output file from the 
in the Set Target Project Information and Capture Repackaging Wizard. It contains 
Settings Panel). the locations of files, .ini files, and 
shortcuts detected by Repackager 
as having been created, modified, 
or removed during repackaging. 
Also, it contains a link to the 
standard.nir and deleted.isr files 
for registry information. 
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File Location Description 
updated.isr Created in the Repackager output directory (specified This is an output file from the 
in the Set Target Project Information and Capture Repackaging Wizard when the 
Settings Panel) Install Monitoring method is used. 
It contains registry additions and 
modifications detected during 
repackaging using installation 
monitoring only. 
deleted.isr Created in the Repackaging output directory This is an output file from the 
(specified in the Set Target Project Information and Repackaging Wizard. It contains 
Capture Settings Panel) registry deletions detected during 
repackaging using installation 
monitoring and snapshot. 
standard. nir Created in the Repackager output directory (specified This is an output file from the 
in the Set Target Project Information and Capture Repackaging Wizard when the 
Settings Panel). Snapshot method is used. It 
contains registry additions and 
modifications detected during 
repackaging using the snapshot 
method. 
* spy Created in the <WindowsDrive>\InstallHook folder. This is an output file from the 
Repackaging Wizard when the 
Install Monitoring method is used. 
It contains API call logs for 
installation monitoring. 
Default.ini <AdminStudio Directory>\<Version Contains the default configuration 
Number>\Repackager directory for Repackager, including default 
exclusion information. 
Repack.log <WindowsFolder> Log file created by the 


Repackaging Wizard. 


Files Used By the Repackager Interface 


File 


Location Description 


*.irp 


Saved in the 

same location 

as the „inc file. 
the Repackager Interface. 


This is a Repackager project file. It is the main file for each repackaged 
or converted setup. It contains information about the .inc files referred to 
and also stores the file, folder, .ini files and registry exclusions made in 


<Exclusion List>.ini 


varies This is an input file for the conversion of the .inc file to an MSI package. 
It contains the list of files, folder, .ini files and registry entries exclusions. 
Users can choose a different exclusion file from the Repackager Interface 
and the exclusions will be reflected in the Interface. 
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File Location 


Description 


Options.ini Saved in the 
same location 


as the .inc file. 


This is an input file for the conversion of the .inc file to an MSI package. 
It contains configuration information about the repackaged setup, 
including whether to use path variables, whether to display a limited user 
interface during installation of the repackaged setup, and whether every 
file will go into its own component. Additionally, the UseSrcFolder flag 
can be used to store the created DevStudio file in the same directory as 
the .inc file. 


ISRepackager.ini File 


The ISRepackager.ini file is the default capture exclusion file for the Repackaging Wizard. It contains exclusions to be 
applied during repackaging, and mainly focuses on specific items that should not be included in applications, such as 
InstallShield Professional-specific COM settings, OS settings, and Internet Explorer settings. Any item excluded 
during capture will not be available for exclusion/inclusion in the Repackager project file. 


The file is located in the Windows folder, and can be edited using the Global Exclusions Editor, or using a text editor. 


D — 


InstallShield strongly recommends you not modify this file, as it increases the likelihood of either inadvertently omitting 

necessary pieces of applications you are repackaging, or including registry entries or files that should not be part of the 
repackaged application. In the first scenario, you may need to recapture your application; in the second, you may need 
to exclude more from the Repackager project. 


Instead, capture your application using the default exclusions in the Repackaging Wizard, and then selectively exclude 
captured data using the Repackager Interface. This way, if you inadvertently exclude a necessary piece, you need only 
reinclude it in Repackager—not recapture the application entirely. 


A) 


Do not confuse the identically named ISRepackager.ini file located in the AdminStudio shared directory. That file is used 
for global exclusions applied to every Repackager project (.irp) opened in the Repackager Interface. 
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Troubleshooting Guidelines for Winlnstall 
Conversion 


Use the following troubleshooting guidelines to identify and fix WinInstall conversion problems. 


Repackager tool supports 6.0, 6.5, and 7.x project formats only. For all other formats, please use 
the WinInstall LE tool available as a free download in Windows 2000 to convert to 7.x files. 


Repackager tool cannot convert WinINSTALL .NAI files—It can only convert WinINSTALL projects 
that have been converted to text (TXT). 


All files must be available— Al] the files that were available to the original WinINSTALL installation project 
must be available to the converted installation at the exact same locations. 


Not all elements of a WinINSTALL installation are converted—Because WinINSTALL installations 
are based on a different technology than Windows Installer, not all elements of a WinINSTALL installation are 
converted. Only the installation of files, registry changes, and other system changes are converted. 


Custom logic is not converted—Custom logic written in WinINSTALL's custom scripting language is not 
converted. 


WinINSTALL environment variable assignments are not converted—To te-add environment variable 
assignments in a Windows Installer installation, open the converted project in InstallShield DevStudio and use the 
Environment Variable view. 


WinINSTALL variables are converted to a Windows Installer variable—If the target path of a file 
contains a WinINSTALL variable, then the WinINSTALL variable is converted to a Windows Installer variable. 


Specify @ variables at conversion time—lIf the source path of a file in WinINSTALL contains either the 
@Server or @Wininstall variable, you can specify the values of these two variables at conversion time in the 
Repackager. 


The WinINSTALL Preinstall and Postinstall scripts are not converted. 


Troubleshooting Guidelines for SMS Conversion 


Use the following troubleshooting guidelines to identify and fix SMS conversion problems. 


All files must be available—All the files that were available to the original SMS installation project must be 
available to the converted installation at the exact same locations. 


Not all elements of an SMS installation are converted—Because SMS installations are based on a 
different technology than Windows Installer, not all elements of a SMS installation are converted. Only the 
installation of files, registry changes, INI Files, ODBC, NT Services, Fonts, Shortcuts, Variables, and other system 
changes are converted. 


Custom logic is not converted—Custom logic written in SMS's custom scripting language is not converted. 


SMS environment variable assignments are not converted—To te-add environment variable 
assignments in a Windows Installer installation, open the converted project in InstallShield DevStudio and use the 
Environment Variable view. 
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Resolving an "Error Building Table File" Error 


When building with Repackager, if you have received the following error message during the build: 


ISDEV: fatal error -5023: Error building table File 


your first step is to go to the Repackager Interface and check whether the number of files installed by this setup is 
greater than 32,767. If it is, this error occurs because Windows Installer supports 32,767 files in the File table but the 
package being built exceeds this limit. See Authoring a Large Package in Windows Installer Help for more 
information. 


If you want to fix this error using AdminStudio, perform the steps listed below. 


Bi 


gi \ 


To fix this error using AdminStudio: 
1. Browse to the appropriate directory: 
2. If you are using the standalone Repackager, browse to the Repackager folder. 


3. If you are using the Repackager on a machine where AdminStudio is fully installed, browse to the 
following directory: 


<AdminStudio INSTALLDIR>\DevStudio\Support\0409 
4. Locate the IsMsiPKg.itp and IsMsiPKgLarge.itp files in this directory. 
5. Rename IsMsiPKg.itp to IsMsiPKg.itp.bak. 
6. Make a copy of IsMsiPKgLarge.itp and rename the copy IsMsiPKg. itp. 
7. Perform the conversion and create the MSI. 
8. Delete IsMsiPKg.itp. 
9. Rename IsMsiPKg.itp.bak back to IsMsiPKg.itp, thereby restoring the original file. 


Transforms and patches cannot be created between two packages with different column types. 


For more information, see the Authoring a Large Package and File Table topics in the Windows Installer Help. 
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The Global Exclusions Editor allows you to configure three types of exclusions: Repackaging, Global Project, and OS 
Snapshot. 


Repackaging Exclusions 


Repackaging exclusions refer to exclusions made during repackage time using the Repackaging Wizard. Any files, 
registry entries, INI files, or shortcuts excluded at this point are not included in the Repackager project. Therefore, if 
you exclude a directory you later need, you need to repackage the legacy setup again. 


The InstallShield best practice is to capture everything using the Repackaging Wizard, and then exclude visually in the 
Repackager Interface. This way, you avoid having to run the Repackaging Wizard again if you accidentally exclude 
necessary files. 


In some cases, you may want to avoid capturing specific data types during repackaging. For example, your 
otganization may never want to capture shortcuts. You can disable capture of shortcuts during repackage time, 
thereby eliminating the need to exclude them later. In snapshot mode, you may want to limit the analysis to a certain 
directory to reduce the time it takes to capture the initial and final snapshot. 


Global Project Exclusions 


Each Repackager project can use a global project exclusion list which marks files, registry entries, shortcuts, and INI 
files as excluded in the Repackager project. If your process dictates that you capture everything and only exclude items 
in the Repackager Interface, then you should set up commonly captured but unnecessary items from the project by 
default. Because all the data from the original capture is intact, if you accidentally exclude necessary files, you can 
always reinclude them from the Repackager Interface and quickly rebuild your Windows Installer package. 


OS Snapshot Exclusions 


Like pre-capture repackaging exclusions, you can use the Global Exclusions Editor to configure exclusions to apply 
during the capture of OS snapshots. However, to maximize the usefulness of OS snapshots, you should avoid editing 
the default snapshot exclusion list (SSnapshot.ini). 
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Exclusions and Repackager 


Global exclusions in Repackager refer to files, registry entries, shortcuts, and INI files that are marked as excluded in 
the Repackager Interface by default when you open a Repackager project or if you change your global exclusions file. 
The captured data is only marked as excluded and not ignored or discarded during capture. You can create a global 
exclusion file in the Global Exclusions Editor, and link it to Repackager from the Project Properties dialog in 
Repackager. 


Exclusions and the OS Snapshot Wizard 


When using the Global Exclusions Editor to configure analysis options for capturing OS snapshots, you are creating 
an exclusion list for files, directories, INI files, INI file sections, and registry data. Items in the exclusion list are not 
captured during the OS snapshot process, and will not be included in the OS snapshot file which is created. 
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Excluding Files 


To add a file to the exclusion list: 


1. From the Files tab, click Edit Exclusions. The Directories and Files Excluded During Analysis Dialog 
opens. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 
%oCOOKIESFOL,.., * 
%oHISTORYFOL... * 
YoINTERNETCA... * 
Y%oNETHOODFOL... * 
%RECENTFOLD,.. * 
+ BAK|.~??|386*.par|.DAO|.G... 
Cy hiberfil.sys 
C:\CONFIG, MSI ? 

C:\CONFIG.REP... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


2. In the resulting Directories and Files Excluded During Analysis Dialog, click New. The File Exclusion 
Information Dialog opens. 


File Exclusion Information 


Excluded Files: 


| * 


3. In the File Exclusion Information Dialog, enter or browse to the directory Path containing the file you 
want to exclude. 


4. Enter the name of the file you want to exclude, or browse to it by clicking browse (...) to the right of the 
Excluded Files field. If you want to exclude multiple files from the same directory, separate them with 
semicolons (|). If you want to exclude all files in a directory, enter an asterisk (*). 


5. Click OK to close the File Exclusion Information Dialog. 


6. The new exclusion appears in the Directories and Files Excluded During Analysis Dialog. Click OK to 
exit the dialog. 
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When configuring file exclusions for Repackager, you are only configuring Repackager to automatically mark the file as 
excluded; this can be changed from within Repackager on a file-by-file basis. However, when configuring file 
exclusions for the OS Snapshot Wizard, files in the exclusion list are not captured in the OS snapshot file. 


Excluding Files with Specific Extensions 


To add files with specific extensions to the exclusion list: 


1. From the Files tab, click Edit Exclusions. The Directories and Files Excluded During Analysis Dialog 
opens. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 


%oCOOKIESFOL,.. * 
%oHISTORYFOL... * 
YoINTERNETCA... * 
%NETHOODFOL... * 
%RECENTFOLD... * 
a BAK|.~??|386*.par|.DA0|.G... 
Ci hiberfil.sys 
C:\CONFIG, MSI = 
C:\CONFIG.REP... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


2. In the resulting Directories and Files Excluded During Analysis Dialog, click New. The File Exclusion 
Information Dialog opens. 


3. In the File Exclusion Information Dialog, enter or browse to the directory containing the files you want to 
exclude. If you want to exclude files with a certain extension from all directories, enter an asterisk (*) 
for the Path value. 


4. Enter an asterisk followed by the extension you want excluded in the Excluded Files field. For example, 
if you want to exclude all .bak files, enter *.bak. If you want to exclude multiple file types from the 
same directory (or from all directories), separate each exclusion with a pipe (|). 


File Exclusion Information 


Excluded Files: 
ba 
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5. Click OK to close the File Exclusion Information Dialog. The new exclusion appears in the Directories 
and Files Excluded During Analysis Dialog. 


6. Click OK to exit the dialog. 


When configuring file exclusions for Repackager, you are only configuring Repackager to automatically mark the file as 
excluded; this can be changed from within Repackager on a file-by-file basis. However, when configuring file 
exclusions for the OS Snapshot Wizard, files in the exclusion list are not captured in the OS snapshot file. 


Excluding Directories 


To add a directory to the exclusion list: 


1. From the Files tab, click Edit Exclusions. The Directories and Files Excluded During Analysis Dialog 
opens. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 
%oCOOKIESFOL,.. * 
%oHISTORYFOL... * 
YoINTERNETCA... * 
Y%NETHOODFOL,.. * 
%oRECENTFOLD,.. * 
wk 


BAK|.~??|386*.par|.DA0|.G... 
hiberfil.sys 
* 


cA Edit... 
C:\CONFIG.MSI 

C:\CONFIG,REP,., 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


Delete.. 


2. In the resulting Directories and Files Excluded During Analysis Dialog, click New. The File Exclusion 
Information Dialog opens. 


3. In the File Exclusion Information Dialog, enter or browse to the directory Path containing the files you 
want to exclude. 
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4. Enter an asterisk (*) in the Excluded Files field. 


File Exclusion Information 


Path: 


Excluded Files: 
[* (J 


5. Click OK to close the File Exclusion Information Dialog. The new exclusion appears in the Directories 
and Files Excluded During Analysis Dialog. 


6. Click OK to exit the dialog. 


When configuring file exclusions for Repackager, you are only configuring Repackager to automatically mark the file as 
excluded; this can be changed from within Repackager on a file-by-file basis. However, when configuring file 
exclusions for the OS Snapshot Wizard, files in the exclusion list are not captured in the OS snapshot file. 
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Editing Existing File Exclusions 


To edit an existing file exclusion: 


1. From the Files tab, click Edit Exclusions. The Directories and Files Excluded During Analysis Dialog 
opens. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 
%oCOOKIESFOL... 
%HISTORYFOL... 
oINTERNETCA,.. 
%oNETHOODFOL... 
%oRECENTFOLD.., 
* «BAK|.??|386*, par|.DAQ].G... 
Cii hiberfil.sys 
C;\CONFIG, MSI 
C:\CONFIG.REP... 
C;\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


2. In the Directories and Files Excluded During Analysis Dialog, select the appropriate exclusion and click 
Edit. the File Exclusion Information Dialog opens. 


File Exclusion Information 


Path: 
P-NETHOODFOLDER% 
Excluded Files: 


| * 


3. In the File Exclusion Information Dialog, change information for the exclusion. 


4. Click OK to close the File Exclusion Information dialog. The edited exclusion is reflected in the 
Directories and Files Excluded During Analysis Dialog. 


5. Click OK to exit the dialog. 


When configuring file exclusions for Repackager, you are only configuring Repackager to automatically mark the file as 
excluded; this can be changed from within Repackager on a file-by-file basis. However, when configuring file 
exclusions for the OS Snapshot Wizard, files in the exclusion list are not captured in the OS snapshot file. 
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Removing File Exclusions 


To remove an existing file exclusion: 


1. From the Files tab, click Edit Exclusions. The Directories and Files Excluded During Analysis Dialog 
opens. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 
%oCOOKIESFOL... 
%oHISTORYFOL,.. 
%oINTERNETCA,.. 
%oNETHOODFOL... 
%oRECENTFOLD.., 
* 


:BAK|.~??|386*,par|.DAO|.G... 
Cii hiberfil.sys 
C;\CONFIG, MSI 

C:\CONFIG.REP... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


2. In the resulting Directories and Files Excluded During Analysis Dialog, select the appropriate exclusion 
and click Delete. 


3. Confirm the exclusion by clicking OK. The deleted exclusion is removed from the Directories and Files 
Excluded During Analysis Dialog. 


4. Click OK to exit the dialog. 


When configuring file exclusions for Repackager, you are only configuring Repackager to automatically mark the file as 
excluded; this can be changed from within Repackager on a file-by-file basis. However, when configuring file 
exclusions for the OS Snapshot Wizard, files in the exclusion list are not captured in the OS snapshot file. 
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Excluding INI Files 


To add an INI file to the exclusion list: 


2. 


From the INI Files tab, click Edit Exclusions. The INI Files and Sections Excluded During Analysis Dialog 
opens. 


INI Files and Sections Excluded During Analysis 


INI Files Excluded Sections 
_DELIS*, INI 
_ISERR31. INI 
DESKTOP. INI 
= 
ISREPACKAGER. INI F 
ISREPACKINFO. INI 
ISSNAPSHOT. INI 
ISSNAPSHOTINFO. INI 
NETDET.INI 
NETINST.INI 
NTUSER.INI 
PROGMAN. INI [Settings]|[Groups] v 

i 


< E 


cs ž *ž 


NWSRCR_INIJI[NWSRCR.reg] 


#e*y# & # # 


In the INI Files and Sections Excluded During Analysis Dialog, click New. The INI File Exclusion 
Information Dialog opens. 


INI File Exclusion Information 


INI File (e.g. WIN. INI): 
| INSTSPY. INI 


Excluded Sections (e.g. [51] | [52] or *): 


E 


In the INI File Exclusion Information Dialog, enter or browse to the INI File you want to exclude. 


If there are specific sections you want to exclude from the INI file, put the section names in brackets ([]) 
and separate them with pipes (|) in the Excluded Sections field. If you want to exclude all sections, put 
an asterisk (*) in the Excluded Sections field. 


Click OK to close the INI File Exclusion Information Dialog. The new exclusion appears in the INI Files 
and Sections Excluded During Analysis Dialog. 


Click OK to exit the dialog. 
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When configuring INI file exclusions for Repackager, you are only configuring Repackager to automatically mark the 
INI file and/or sections as excluded; this can be changed from within Repackager on an INI file by INI file basis. 
However, when configuring INI file exclusions for the OS Snapshot Wizard, INI files in the exclusion list are not 


captured in the OS snapshot file. 


Excluding Sections from INI Files 


—_ 
To add an specific INI file section to the exclusion list: 


1. From the INI Files tab, click Edit Exclusions. The INI Files and Sections Excluded During Analysis Dialog 
opens. 


INI Files and Sections Excluded During Analysis 


INI Files Excluded Sections 


_DELIS*. INI 
_ISERR31.INI 
DESKTOP. INI 
ISREPACKAGER INI 
ISREPACKINFO, INI 
ISSNAPSHOT. INI 
ISSNAPSHOTINFO. INI 
NETDET.INI 
NETINST. INI 
NTUSER.INI 
PROGMAN, INI [Settings]|[Groups] 


< | 


sx £ 


NWSRCR_INIJ|[NWSRCR.reg] 


#2] ts F 


2. In the INI Files and Sections Excluded During Analysis Dialog, click New. 


3. In the INI File Exclusion Information Dialog, enter or browse to the INI File containing the section you 


want to exclude. 


4. To exclude a specific INI file section, enter the section name in brackets ([]) in the Excluded Sections 
field. If there are multiple sections, separate them with pipes (|). 


INI File Exclusion Information 


INI File (e.g. WIN.INI): 


Options. ini 


Excluded Sections (e.g. [51] | [52] or *}: 
[SECTION1]|[SECTION2] 
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5. Click OK to close the INI File Exclusion Information Dialog. The new exclusion appears in the INI Files 
and Sections Excluded During Analysis Dialog. 


6. Click OK to exit the dialog. 


When configuring INI file exclusions for Repackager, you are only configuring Repackager to automatically mark the 
INI file and/or sections as excluded; this can be changed from within Repackager on an INI file by INI file basis. 
However, when configuring INI file exclusions for the OS Snapshot Wizard, INI files in the exclusion list are not 
captured in the OS snapshot file. 


Editing Existing INI File Exclusions 


To edit an existing INI file exclusion: 


1. From the INI Files tab, click Edit Exclusions. The INI Files and Sections Excluded During Analysis Dialog 
opens. 


INI Files and Sections Excluded During Analysis 


INI Files Excluded Sections 
_DELIS*, INI 
_ISERR31.INI 
DESKTOP. INI 
I 
ISREPACKAGER. INI F 
ISREPACKINFO. INI 
ISSNAPSHOT. INI 
ISSNAPSHOTINFO. INI 
NETDET. INI 
NETINST.INI 
NTUSER.INI 
PROGMAN. INI [Settings]|[Groups] 

i 


s 


NWSRCR_INI]|[NWSRCR.reg] 


# ay # & & # 


2. In the INI Files and Sections Excluded During Analysis Dialog, select the appropriate exclusion and 
click Edit. The INI File Exclusion Information Dialog opens. 


INI File Exclusion Information 


INI File (e.g. WIN. INI): 
| 


Excluded Sections (e.g. [51] | [52] or *): 


| * 


3. In the INI File Exclusion Information Dialog, modify the exclusion. 
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4. Click OK to close the INI File Exclusion Information Dialog. The edited exclusion is updated in the INI 
Files and Sections Excluded During Analysis Dialog. 


5. Click OK to exit the dialog. 


When configuring INI file exclusions for Repackager, you are only configuring Repackager to automatically mark the 
INI file and/or sections as excluded; this can be changed from within Repackager on an INI file by INI file basis. 
However, when configuring INI file exclusions for the OS Snapshot Wizard, INI files in the exclusion list are not 
captured in the OS snapshot file. 


Removing INI File Exclusions 


To delete an existing INI file exclusion: 


1. From the INI Files tab, click Edit Exclusions. The INI Files and Sections Excluded During Analysis Dialog 
opens. 


INI Files and Sections Excluded During Analysis 


INI Files Excluded Sections 
_DELIS*. INI 
_ISERR31. INI 
DESKTOP. INI 
I 
ISREPACKAGER. INI 7 
ISREPACKINFO. INI 
ISSNAPSHOT. INI 
ISSNAPSHOTINFO. INI 
NETDET. INI 
NETINST.INI 
NTUSER.INI 
PROGMAN. INI [Settings]|[Groups] 
< | 


se £ & 


NWSRCR_INI]|[NWSRCR.reg] 


# ay # & & # 


2. In the INI Files and Sections Excluded During Analysis Dialog, select the appropriate exclusion and 
click Delete. 


3. Confirm the deletion by clicking OK. The deleted exclusion is removed from the INI Files and Sections 
Excluded During Analysis Dialog. 


4. Click OK to exit the dialog. 
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When configuring INI file exclusions for Repackager, you are only configuring Repackager to automatically mark the 
INI file and/or sections as excluded; this can be changed from within Repackager on an INI file by INI file basis. 
However, when configuring INI file exclusions for the OS Snapshot Wizard, INI files in the exclusion list are not 
captured in the OS snapshot file. 


Excluding Registry Data 


ita 
To add registry data to the exclusion list: 


1. From the Registry tab, select Edit Exclusions. The Keys Excluded During Registry Analysis Dialog opens. 


Keys Excluded During Registry Analysis 


Key 
HKEY_CLASSES_ROOT\CLSID\{0B124F8C-91,.,. 
HKEY_CLASSES_ROOTICLSID\{22D84EC7-E2.., 
HKEY_CLASSES_ROOT\CLSID\{352EC2B7-88... 
HKEY_CLASSES_ROOT\CLSID\{8C3C1B17-E5.., 
HKEY_CLASSES_ROOT\CLSIDI{91814EC0-B5... 
HKEY_CLASSES_ROOT\CLSIDI{AA7E2086-CB.... 
HKEY_CLASSES_ROOTICLSIDI{AA7EZ087-CB. .. 
HKEY_CLASSES_ROOTICLSIDI{C9CD1A93-D7... 
HKEY_CLASSES_ROOTICLSIDI{CFCCC7A0-A... 
HKEY _CLASSES_ROOT\CLSIDI{E7D06080-23... 
HKEY_CLASSES_ROOT\CLSID\{F4817E4B-04... 
HKEY_CLASSES_ROOT\INSTALLER 
HKEY_CLASSES_ROOTWINTERFACE\{0034539... 
HKEY_CLASSES_ROOT\INTERFACE\{067DBA... 
< i 


* £ SE E SE i E HF * FOF 
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2. From the Keys Excluded During Registry Analysis Dialog, click New. The Choose Registry Key Dialog 
opens. 


Choose Registry Key 


S Desktop 
GH HKEY_CLASSES_ROOT 
E HKEY_CURRENT_USER 
w- AppEvents 
Console 
=- Control Panel 
Environment 
E- Identities 
S- {B1876341-419E-4C34-9171-2AD9B63BASFO} 
B- Software 
E- Microsoft 
=) Outlook Express 
5.0 
Recent Stationery List 
Rules 
=Œ- Shared Settings 
E- Keyboard Layout 
E- Network 
H- Printers, 


al M es 
HKEY_CURRENT_USER\Identities\{B 187634 1-419E-4C34-9171-24D9B63BA5F0}\Soft. 


v 


3. From the Choose Registry Key Dialog, browse to the registry key you want to exclude and click OK. 
The key is added to the Keys Excluded During Registry Analysis Dialog. 


4. |f you want to exclude a certain value in the key, select it from the Keys Excluded During Registry 
Analysis Dialog and click Edit. The Edit Registry Key Dialog opens. 
Edit Registry Key 


Key Name: 
Ess ROOTICLSIDHAA7E2087-CB55-11D2-8094-00104B1F9838 


Value Name: 


| * 


5. From the Edit Registry Key Dialog, provide the Value Name you wont to exclude, and click OK to close 
the dialog. The exclusion information is reflected in the Keys Excluded During Registry Analysis dialog. 


6. Click OK to close the dialog. 


When configuring registry exclusions for Repackager, you are only configuring Repackager to automatically mark the 
registry entry and/or values as excluded; this can be changed from within Repackager on an registry key by registry 
key basis. However, when configuring registry exclusions for the OS Snapshot Wizard, registry data in the exclusion 
list is not captured in the OS snapshot file. 
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Editing Existing Registry Exclusions 


To edit an existing registry exclusion: 


1. From the Registry tab, select Edit Exclusions. The Keys Excluded During Registry Analysis Dialog opens. 


Keys Excluded During Registry Analysis 


HKE¥_CLASSES_ROOT\CLSID\{0B124F8C-91.., 
HKEY_CLASSES_ROOT\CLSID\{22D84EC7-E2... 
HKEY_CLASSES_ROOT\CLSIDI{352EC2B7-88... 
HKEY_CLASSES_ROOT\CLSIDI{8C3C1B17-E5... 
HKEY_CLASSES_ROOT\CLSIDI{91814EC0-B5... 
HKEY_CLASSES_ROOT\CLSIDI{AA7E2086-CB... 


HKEY_CLASSES_ROOTICLSID\{447E2087-CB... 


HKEY_CLASSES_ROOT\CLSID\{C9CD1493-D7,., 


HKEY_CLASSES_ROOT\CLSID\{CFCCC7A0-A... 


HKEY_CLASSES_ROOT\CLSID\{E7D06080-23... 


HKEY_CLASSES_ROOT\CLSID\{F4817E4B-04.., 
HKEY_CLASSES_ROOT\INSTALLER 
HKEY_CLASSES_ROOT\INTERFACE|{0034539... 
HKEY_CLASSES_ROOT\INTERFACE\{067DBA... 


č | 


* © © © © © FBR © F FF F 


2. On the Keys Excluded During Registry Analysis Dialog, select the registry key that you want to edit and 
click Edit. The Edit Registry Key Dialog opens. 


Edit Registry Key 


Key Name: 


BSES_ROOTICLSIDI{447E2087-CB55-11D2-8094-0010461F 9833 


Value Name: 


* 


3. In the Edit Registry Key Dialog, modify the exclusion as necessary. 


4. Click OK to close the dialog. The exclusion information is reflected in the Keys Excluded During Registry 
Analysis Dialog. 


5. Click OK to close the dialog. 
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When configuring registry exclusions for Repackager, you are only configuring Repackager to automatically mark the 
registry entry and/or values as excluded; this can be changed from within Repackager on an registry key by registry 
key basis. However, when configuring registry exclusions for the OS Snapshot Wizard, registry data in the exclusion 
list is not captured in the OS snapshot file. 


Removing Registry Exclusions 


ual 
To delete an existing registry exclusion: 


1. From the Registry tab, select Edit Exclusions. The Keys Excluded During Registry Analysis Dialog opens. 


Keys Excluded During Registry Analysis 


Key 
HKEY_CLASSES_ROOT\CLSIDI{0B124F8C-91.., 
HKEY_CLASSES_ROOT\CLSID\{22D84EC7-E2... 
HKEY_CLASSES_ROOT\CLSIDI{352EC2B7-8B... 
HKEY_CLASSES_ROOT\CLSIDI{8C3C1B17-E5... 
HKEY_CLASSES_ROOT\CLSIDI{91814EC0-B5... 
HKEY_CLASSES_ROOT\CLSIDI{AA7E2086-CB... 
HKEY_CLASSES_ROOTICLSIDI{4A7E2087-CB... 
HKEY_CLASSES_ROOT\CLSIDI{C9CD1A93-D7... 
HKEY_CLASSES_ROOT\CLSIDI{CFCCC7AO-A.., 
HKEY_CLASSES_ROOT\CLSIDI{E7D06080-23... 
HKEY_CLASSES_ROOT\CLSID\{F4817E4B-04.., 
HKEY_CLASSES_ROOT\INSTALLER 
HKEY_CLASSES_ROOT\INTERFACE}{0034539... 
HKEY_CLASSES_ROOT\INTERFACE\{067DBA... 
< i 


* * * xX E * © * * * 


2. On the Keys Excluded During Registry Analysis Dialog, select the registry key that you want to delete 
and click Delete. 


3. Confirm the deletion by clicking OK. The deleted exclusion is removed from the Keys Excluded During 
Registry Analysis Dialog. 


4. Click OK to exit the dialog. 


When configuring registry exclusions for Repackager, you are only configuring Repackager to automatically mark the 
registry entry and/or values as excluded; this can be changed from within Repackager on an registry key by registry 
key basis. However, when configuring registry exclusions for the OS Snapshot Wizard, registry data in the exclusion 
list is not captured in the OS snapshot file. 
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Resetting Exclusions to Default Values 


Each tab in the Global Exclusions Editor includes a button to reset the tab to its default values. When you press this 
button, the associated exclusions are reset to their last saved values—but exclusions for the other tabs are retained. 
For example, you can undo all your unsaved changes for file exclusions, without affecting changes to registry or INI 
file exclusions. 


To reset exclusions: 


Select the appropriate tab which you want to reset exclusions for and click Reset to Default Values. 
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Global Exclusions Editor Reference 


This section describes each tab, menu, and dialog in the Global Exclusions Editor. 


fama’ 
f \ 
\ -d 


l 


Menus are not available when running the Global Exclusions Editor from within the OS Snapshot Wizard. You can 
specify the settings file you are configuring from the Ready to Capture OS Snapshot panel. 


The following table provides a description of each menu command: 


Keyboard 

Menu Command Shortcut Description 

File New Ctrl+N Creates a new, blank settings file. 

File Open | Local Settings Opens the local settings file (isrepackager.ini) from the 
Windows directory. Open this settings file when you are 
working in a non-networked environment and are 
repackaging in a standalone machine. 

Open | Shared Opens the settings file (isrepackager.ini) from the 

Settings AdminStudio shared directory. Open this settings file 
when working in a team environment where the exclusion 
list needs to be stored in a centralized location. 

Open | InstallShield Opens the settings file (default.ini) from the Repackager 

Settings directory (location of Repackager executable). 

Open | Custom Allows you to browse to an Global Exclusions Editor 

Settings settings file and open it. You would create a custom 
exclusion file based upon your company's requirements. 

File Save Ctrl+S Saves the current Global Exclusions Editor settings file. 

File Save As Saves the current Global Exclusions Editor settings file to 
the name and location specified. 

File Exit Exits the Global Exclusions Editor. 

Help Help Library Displays the online Help Library. 

Help About Global Displays the About Global Exclusions Editor Dialog. 

Exclusions Editor 
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Files Tab 


From the Files tab, you can either click Edit Exclusions to configure file exclusions, or click Reset to Default Values 
to return file exclusions to their last saved state. 


*: Options.ini - Global Exclusions Editor 
File Help 


INI Files | Registry 


Specify the files you want automatically marked as excluded in your Repackager 
Project. 


Edit Exclusions... Reset to Default Values 


File exclusions for Repackager indicate which files are automatically marked as excluded in the Repackager project. 
File exclusions in the OS Snapshot Wizard indicate files that will be excluded from the captured OS snapshot. 


InstallShield highly recommends you do not edit the default exclusions for the OS Snapshot Wizard. 
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INI Files Tab 


From the INI Files tab, you can either click Edit Exclusions to configure INI file exclusions, or click Reset to Default 
Values to return INI file exclusions to their last saved state. 


Æ Options.ini - Global Exclusions Editor 
File Help 


LINI Files || Registry 


Specify the INI files and INI file sections you want automatically marked as excluded in 
your Repackager project. 


Edit Exclusions... Reset to Default Values 


INI file exclusions for Repackager indicate which INI files and sections are automatically marked as excluded in the 
Repackager project. INI file exclusions in the OS Snapshot Wizard indicate INI files and sections that will be 
excluded from the captured OS snapshot. 


InstallShield highly recommends you do not edit the default exclusions for the OS Snapshot Wizard. 
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Registry Tab 


From the Registry tab, you can either click Edit Exclusions to configure registry exclusions, or click Reset to Default 
Values to return registry exclusions to their last saved state. 


*: Options.ini - Global Exclusions Editor 
File Help 


Files || INI Files |: 


Specify the registry keys and values you want automatically marked as excluded in 
your Repackager project. 


Edit Exclusions... Reset to Default Values 


Registry exclusions for Repackager indicate which registry keys are automatically marked as excluded in the 
Repackager project. Registry exclusions in the OS Snapshot Wizard indicate registry keys that will be excluded from 
the captured OS snapshot. 


InstallShield highly recommends you do not edit the default exclusions for the OS Snapshot Wizard. 
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Directories and Files Excluded During Analysis 
Dialog 


This dialog, which is accessed by clicking Edit Exclusions on the Global Exclusions Editor Files Tab, contains a list of 
paths and files currently excluded from the capture process. Specific files, file extensions, and the entire contents of 
specified directories can be excluded. 


Directories And Files Ignored During Analysis 


Paths Excluded Files 
%oCOOKIESFOL,.. 
%oHISTORYFOL... 
oINTERNETCA,.. 
%eNETHOODFOL... 
%oRECENTFOLD... 
* \BAK|.~??|386*,par|.DAO|.G... 
enn hiberfil. sys 
C:\CONFIG. MSI 

C:\CONFIG.REP... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 
C:\DOCUMENTS ... 


The following three buttons allow you to add, edit, and remove files and directories from the exclusion list: 


Button Description 

New Displays the File Exclusion Information Dialog from which you can specify additional file exclusions. 

Edit Brings up a dialog from which you can change settings for the currently selected path in the exclusion list. 
Delete Deletes the currently selected path from the exclusion list. 


File Exclusion Information Dialog 


The File Exclusion Information Dialog, which is accessed by clicking New or Edit on the Directories and Files 
Excluded During Analysis Dialog, allows you to specify files to be excluded from analysis by the capture tool. 


File Exclusion Information 


Path: 
P:NETHOODFOLDER% 


Excluded Files: 


[* 


Enter or browse to the path you want to exclude, and provide the file(s) to be excluded. In addition to specifying 
individual files, you can also exclude all files with a certain extension by entering an asterisk (*) plus the extension (for 


example, *.txt) in the Excluded Files field. You can also exclude all files in a directory by only entering an asterisk in 
the Excluded Files field. 
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Click OK to return to the Directories and Files Excluded During Analysis Dialog. 


INI Files and Sections Excluded During Analysis 
Dialog 


When you click the click Edit Exclusions on the INI Files tab, the INI Files and Sections Excluded During Analysis 
dialog appears. 


INI Files and Sections Excluded During Analysis 


INI Files Excluded Sections 
_DELIS*. INI 
_ISERR31.INI 
DESKTOP. INI 
= 
ISREPACKAGER. INI p 
ISREPACKINFO. INI 
ISSNAPSHOT. INI 
ISSNAPSHOTINFO, INI 
NETDET.INI 
NETINST.INI 
NTUSER. INI 
PROGMAN. INI [Settings]|[Groups] v 


<i | B 


se ** 


NWSRCR_INI]|[NWSRCR. reg] 


#2*#]4) e & # 


This dialog contains a list of the INI files and sections within INI files excluded during analysis. If all sections are 
excluded, an asterisk (*) is used in the Excluded Sections column. 


Click New to display the INI File Exclusion Information Dialog and add a new INI file or sections of an INI file to 
the exclusion list. Click Edit to edit currently excluded INI files, and click Delete to remove the selected INI file from 
the Exclusion list. 


INI File Exclusion Information Dialog 


The INI File Exclusion Information Dialog, which is accessed by clicking New or Edit on the INI Files and Sections 
Excluded During Analysis Dialog, allows you to specify INI files to be excluded from analysis by the capture tool. 


INI File Exclusion Information 


INI File (e.g. WIN.IND): 


INSTSPY. INI 


Excluded Sections (e.g. [51] | [52] or *): 


* 


Enter or browse to the INI file you want to exclude, and provide the section(s) to be excluded. Sections must be 
enclosed in square brackets ({]), and separated by vertical bars (|) if more than one section in an INI file is to be 
excluded (for example, [Groups], [Settings]). You can also exclude all INI file sections by only entering an asterisk in 
the Excluded Sections field. 


Click OK to return to the INI Files and Sections Excluded During Analysis Dialog. 
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Keys Excluded During Registry Analysis Dialog 


When you click Edit Exclusions from the Registry Tab, the Keys Excluded During Analysis of the Registry dialog 
appears. 


Keys Excluded During Registry Analysis 


Key 
HKEY_CLASSES_ROOT\CLSID\{0B124F8C-91.., 
HKEY_CLASSES_ROOT\CLSID\{22D84EC7-E2... 
HKEY_CLASSES_ROOT\CLSID\{352EC2B7-8B... 
HKEY_CLASSES_ROOT\CLSID\{8C3C1B17-E5.,. 
HKEY_CLASSES_ROOT\CLSID\{91814EC0-B5... 
HKEY_CLASSES_ROOT\CLSID\{447E2086-CB.., 
HKEY_CLASSES_ROOT\CLSID\{447E2087-CB... 
HKEY_CLASSES_ROOT\CLSID\{C9CD1493-D7,.. 
HKEY_CLASSES_ROOT\CLSID\{CFCCC7A0-A... 
HKEY_CLASSES_ROOT\CLSID\{E7D06080-23... 
HKEY_CLASSES_ROOT\CLSID\{F4817E4B-04... 
HKEY_CLASSES_ROOT\INSTALLER 
HKEY_CLASSES_ROOT\INTERFACE\{0034539... 
HKEY_CLASSES_ROOT\INTERFACE\{067DBA... 
< | 


* 2% & & & ERE HF HH KH OK 


This contains a listing of keys and values to be excluded during registry analysis. For keys that have specific values 
excluded, the value name appears in the Value column. For keys that have all values excluded, an asterisk (*) 
represents the entire key in the Value column. 


There are three buttons available from this dialog that are used to add, edit, or remove keys from the exclusion list: 


Button Description 


New Displays the Choose Registry Key Dialog, from which you can select registry keys and values for exclusion 
during analysis. 


Edit Brings up a dialog from which you can modify the selected key's exclusion settings. 


Delete Removes the selected key from the exclusion list. 


To modify the registry key list, either click New to add new key to the exclusion list, click Edit to modify an existing 
key's settings, or click Delete to remove the key from the exclusion list. 
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Choose Registry Key Dialog 


The Choose Registry Key dialog, which is accessed by clicking New on the Keys Excluded During Registry Analysis 
Dialog, provides a way for you to select registry keys that you want excluded from analysis. 


Choose Registry Key 


GH HKEY_CLASSES_ROOT 
E HKEY_CURRENT_USER 
H- AppEvents 
Console 
=- Control Panel 
Environment 
B- Identities 
E {B1876341-419E-4C34-917 1-24D9B63BA5F0} 
& Software 
E- Microsoft 
E- Outlook Express 
5.0 
Recent Stationery List 
Rules 
W- Shared Settings 
W- Keyboard Layout 
Network 
+). Printers, 


< | is 


HKEY_CURRENT_USER\Identities\{B1876341-419E-4C34-9171-24D9B63BA5F0}\Softw 


{v 


Navigate through the tree until you find the key you want to exclude and click OK to return to the Keys Excluded 
During Analysis of the Registry Dialog. 


By default, all values in that key are excluded. To modify this, select the key from the Keys Excluded During Analysis of 
the Registry dialog and click Edit to display the Edit Registry Key Dialog. 


You can also select a registry hive to exclude. As with individual registry keys, all values (and keys) contained in the 
hive are excluded by default. 
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Edit Registry Key Dialog 


When you select a registry key on the Keys Excluded During Registry Analysis Dialog and click Edit, the Edit Registry 
Key Dialog appears. 


Edit Registry Key 


Key Name: 


Value Name: 


* 


You can modify the Key Name and/or Value Name excluded during analysis. 


Click OK to return to the Keys Excluded During Registry Analysis Dialog. 


About Global Exclusions Editor Dialog 


The About Global Exclusions Editor dialog displays version and copyright information for the Global Exclusions 
Editor. This may be useful if you need to report a problem encountered when using the Global Exclusions Editor. 


About InstallShield Global Exclusions Editor 
InstallShield AdminStudio 


Global Exclusions Editor 
Version 5.0 


Copyright © 1997-2003 InstallShield Software Corporation. 
All rights reserved. 
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Authoring and Enhancing Packages 


InstallShield® DevStudio provides the most comprehensive and flexible setup-creation technology available for the 
Windows Installer. With the latest InstallShield installation development environment (Interface) you can create setup 
packages that utilize Windows Installer technology, while harnessing the flexibility provided by InstallScript, 
InstallShield's development language. 


Administrators can also take advantage of DevStudio to customize repackaged legacy setups, further enhancing them 
prior to deploying them in production environments. DevStudio contains integrated ConflictSolver functionality 
(AdminStudio Professional only), allowing you to perform conflict identification before leaving DevStudio. 


For information on how to use InstallShield DevStudio, go to the following location in InstallShield HelpNet 
(helpnet.installshield.com): 


hitp://helpnet.installshield.com/Robo/BIN/Robo.dll2tpc=/robo/projects/helplibdevstudio9 /IHelpContents.htm 


AdminStudio-Specific Functionality in 
DevStudio 


When running InstallShield DevStudio from AdminStudio, some AdminStudio-specific functionality is enabled: 


Functionality 


Description 


Launching Repackager for conversion of 
Novell ZENworks projects (.axt), Microsoft SMS 
Installer projects (.ipf), WinINSTALL exported 
text files (.txt), Wise Installation files (.wse), and 
legacy Repackager projects (inc). 


When you attempt to open any of these file types in DevStudio, you can 
launch Repackager to perform the conversion. 


ConflictSolver options in the Options dialog 
(AdminStudio Professional Edition only) 


From the DevStudio Options dialog (available from the Tools menu), an 
additional tab for ConflictSolver configuration is available. If you have 
administrator privileges (using AdminStudio security), you can change the 
Application Catalog used for the current DevStudio session. You can also 
access the ConflictSolver Options Dialog (by clicking Advanced), allowing 
you to modify ConflictSolver settings such as import options and conflict 
options. 


Importing packages and merge 
modules into ConflictSolver from 
DevStudio (AdminStudio Professional Edition 


only) 


From the Project menu, you can access the ConflictSolver submenu, 
allowing you to access the ConflictSolver Import Wizard. Using this 
Wizard, you can import Windows Installer packages and merge modules 
into ConflictSolver. 
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Checking for conflicts from DevStudio From the ConflictSolver submenu, you can also launch the Conflict Wizard. 
(AdminStudio Professional Edition only) Using this Wizard, you can check for package conflicts before leaving 
DevStudio. 


AdminStudio security applies to ConflictSolver functionality in DevStudio. If the AdminStudio administrator has not 
provided sufficient permissions, you may not be able to access some of these features. 


ConflictSolver Tab on DevStudio Options 
Dialog 


When DevStudio is invoked from ConflictSolver, an additional tab appears on the DevStudio Options Dialog: 
ConflictSolver. 


Options 


General | File Locations | Path Variables | User InterFace | Preferences | Source Control | 
Directory | Resource | Validation | Merge Modules | Quality | .NET ConfictSolver | Files View | 


ConfictSolver Options 


The Following options allow you to configure how InstallShield interacts with your ConflictSolver 
program, Click Browse to change the default conflict solver database. Click the Advanced button 
to configure more advanced ConflictSolver settings, 
Default Conflict Database: 

C:\AdminStudio Shared\HoweTechnology.mdb 


Advanced... | 
OK | Cancel | Help | 


From this tab, you can specify the Application Catalog (ConflictSolver database) to which you want to connect when 
using integrated ConflictSolver functionality in DevStudio. If you click the folder icon, the Connect to Application 
Catalog Dialog appears, from which you can specify the application catalog type and location. 


If you click Advanced, the ConflictSolver Options Dialog appears. 
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Using Tuner, you can add to, modify, or remove information from a Windows Installer package. This involves 
creating a transform file, where all the modifications are stored. When you install the package and transform together, 
your modifications are reflected in the installation. 


Tuner allows you to configure the initial state of features, add or remove files from an installation, edit registry entries, 
configure setup properties, set Add/Remove Programs options, and configure servers for application resiliency. You 
can also validate Windows Installer packages and transform files to ensure they conform to Microsoft guidelines. 


When to Use Tuner vs. DevStudio 


Most system administrators use InstallShield DevStudio to import repackaged setups and convert them into Windows 
Installer packages. DevStudio is also ideal for making changes to the package that you want reflected in all 
deployments of the package. However, InstallShield recommends you use Tuner to create transforms for changes that 
you only want to affect a particular deployment, rather than every installation. 
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Working with Transforms 


The Microsoft-designated term transform refers to a specific file type used to customize a Windows Installer-based 
installation. A transform contains all modification information, such as whether features are installed, how they are 
installed, which files, shortcuts, and registry entries are included, and Windows 2000 and XP Add/Remove Programs 
information. Transform files use an .mst extension. 


For example, you may need to customize an installation for different departments in your company. Typical business 
productivity suites come with a spreadsheet program, a word processor, and a presentation tool. Your accounting 
department may only need the spreadsheet and the presentation programs. On the other hand, the writing department 
may need only the word processor and the spreadsheet. A third department may need the entire suite of applications. 
Instead of manually setting up every person in the company, you can take the original setup of the entire suite, and 
create a customization project in the form of a transform to meet the needs of each department. A transform would 
need to be created for every configuration that you plan to use. 


Once you have created a transform, you can apply it at run time, depending on whose machine the application is 
being installed on. For example, in the accounting department, the transform limits the installation to include only the 
spreadsheet and presentation programs. 


In some cases, it may be necessary to have multiple transform files for an installation. For example, a vendor may use 
a transform file for language-specific information. When you want to customize that MSI file, you need to include the 
preexisting transform so your modifications affect the entire existing package. 
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Creating New Transform Files 


To create a new transform file: 


1. Launch InstallShield Tuner from the AdminStudio interface. The InstallShield Today View appears: 


InstallShield Tuner 


|| File Edit View Go Project Tools Help 


joeus|DO|t+e>|matl|eor!:los 
A InstallShield Today 


InstallShield Tuner 


Wt Welcome 


Welcome to InstallShield Tuner Welcome to InstallShield Tuner 


|_)create anew transform If you receive software in the MSI format, AdminStudio allows you to build 
Transforms to adapt the installation to the needs of your environment. 
AdminStudio's Tuner module generates Transforms (.MST files) providing the 
only Microsoft-recommended way to customize Windows Installer packages 
© Open a recent transform for deployment. Either step through the installation sequence to catch all of 
your preferred settings, or open up the MSI and easily make your changes. 
Open a recent transform file (.mst) Customizations such as removing or relocating shortcuts, changing registry 
settings, adding files, pre-configuring ODBC databases, or creating a = 
response file are all easily made through a clean interface that removes most 
of the complexity of working with a typical setup. Using Tuner, you can easily 
Open an existing transform file (.mst} and quickly customize Windows Installer packages to meet your 
organization's needs, including limiting the features installed, adding custom 
files to the installation, and setting property values. You can also make 
@ Installshield on the Web multiple customizations from the same base setup, drastically reducing the 
Explore InstallShield's Internet resources time to deployment. The result is an easy and intuitive way to ensure an 
installation is really your installation, 


Create a new transform file (.mst) 


B Open an existing transform 
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2. Click Create a new transform file on the left side of the view or select New from the File menu. The right 


3. 


4. 


side of the view changes to display the fields necessary to create a new transform. 


Base Windows Installer Package 
Select an MSI file. 


| Browse 


m 


Provide a list of additional transforms to be applied. 


Windows Installer Transforms 
Provide a new project name and location (or accept the default), and click Create to create a new 


Customization project. 
| 


C] Response Transform 


In the Select an MSI File field of the Base Windows Installer Package area, enter the name and location 
of the Windows Installer package that you are customizing, or click Browse to locate it. 


If there are transforms already associated with the Windows Installer package, (for example, previous 
customizations or transforms containing language-specific information), go to the Provide a list of 
additional transforms to be applied area and click the New button: 


A new entry appears in the list. 


Provide a list of additional transforms to be applied. 


When an entry appears in the list, click the Browse button (...) to the right of it and locate the transform. 
If multiple transforms are associated with this package, use the Move Up and Move Down buttons to 
specify the order in which the transforms are applied. 


Baha 
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When using multiple transforms, keep in mind that the order in which they are applied is critical. For example, 
if you create a transform for a Windows Installer package that creates a new value for a property, and then 
create a second transform that changes the value created in the first transform, everything works correctly. 
However, if you apply the second transform first, that transform is attempting to modify the property's value, 
instead of creating it. That will result in an error. 


One simple example of where this may be a problem is with the default company name. If the value is not set 
by default, and you set it in using the first transform, a new value for the property is created. If you create a 
second transform that modifies the combined original package and first transform, and the second transform 
changes the default company name, it is only changing the property. However, if you try to apply the second 
transform without the first one, Windows Installer interprets this as trying to change a null value fo another 
value, which will result in an error. 


5. By default, the transform will be created in the same directory as the Windows Installer package, and 
named the same as the base package with an .mst extension. However, if you want to change the 
name and/or location of the transform, you can also do so in the Windows Installer Transforms area. 
Click Browse to open the Save Customization File dialog. 


Save Customization File 


Save in: | © AdminStudio Shared 


()conflictSolver 
(Help 

My Recent (Templates 
Documents (upgrade Logs 
EB acroProNew.mst 
EBorcaz.mst 
EBorca.mst 


File name: 


My Network — Save as type: | Customization File [mst] 


Navigate to the directory in which you want to store the transform file you are creating. Provide the 
name of the transform with an .mst extension (for example, MyTransform.mst) and click Save. The 
dialog closes and the path and file name appear in the edit field. 
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6. 


If you want to create a Response Transform, check the appropriate box. If you are using a response 
transform, you can specify additional command-line properties (in property name/value pairs 
separated by semicolons) to pass to the response transform. These must be PUBLIC properties, and only 
control how the dialogs are displayed during creation of the response transform. They are not persisted 
outside of the Ul sequence during creation. For example, you can pass the property/value pair 
ARPHELPTELEPHONE=1-1 111-111-1111 to set the value of the Help Telephone field of Add/Remove 
Programs. 


Response Transform 


Command line properties (separated by ';') that will be passed to the Windows Installer package 
while creating a response transform 


|ARPHELPTELEPHONE=1 -111-111-1111 


You might pass a property/value pair during response transform creation to display all dialogs during 
an installation that may not be displayed based on your system configuration (for example, to show 
Windows 9x-only dialogs on a Windows NT platform). You can then make appropriate responses and 
have them included in your transform. 


Ensure all the information entered is correct, and click Create. 


a If you are creating a Standard Transform, the transform file is opened in the Tuner interface, 
displaying the Package Validation view. 


m If you are creating a Response Transform, a simulated installation of the selected application 
begins. Step through the installation, making changes as necessary. When you reach the end of the 
installation sequence and click Install, the installation will exit and the Tuner interface will open your 
transform, displaying the Package Validation view. Your transform contains all of the changes you 
made during the simulated installation. 


( w) 


You can access information about the original MSI file and associated transforms by selecting Properties from 
the File menu. 
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Opening Existing Transforms 


On the Tunet's InstallShield Today View, when you click on Open an existing transform file, the pane on the right of 
the interface changes. You can then specify the name and location of the base Windows Installer package, any 
associated transforms, and the name and location of the transform file. 


InstallShield Tuner 


|| File Edit Yiew Go Project Tools Help 


joeHna|DO|t++>|Bax~|eo.!\eoe@ 
InstallShield Today 


Base Windows Installer Package 


Select an MSI file. 
Wt Welcome 


Welcome to InstallShield Tuner 


Provide a list of additional transforms to be applied. 


0 Create a new transform 
Create a new transform file (.mst} 


oS Open a recent transform 


Open a recent transform file (.mst) 


© Open an existing transform Windows Installer Transforms 


Open an existing transform file (.mst) Select an MST file. 


@ installshield on the Web | 


Explore InstallShield's Internet resources 


Open 


Generally, you will only use this option when opening existing transforms that were created by a product other than 
Tuner, or created by someone other than yourself. Transforms you create using Tuner are more easily accessed through 
using the Open a recent transform file selection. 
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Opening Recently Accessed Transforms 


On Tuner's InstallShield Today View, when you click on Open a recent transform file, the pane to the right changes 
to a list containing your most recently accessed transforms. 


InstallShield Tuner 
|| Ble Edt view Go project Tools Help 
jaeHa@|DO|\t++>|Bax|eG.! os 
A InstallShield Today 


Select a customization project from the most recently used list and click Open. 
Åt Welcome Project MSI Location Project Location 
Welcome to InstallShield Tuner | &) Orcal mst C:\AdminStudio Shared\Orca.msi C:\AdminStudio Shared, 
| Aj PackageForTheWeb 4.mst C:\AdminStudio Shared\PackageFor... C:AdminStudio Shared’, 
Q Create a new transform | 
Create a new transform file (,mst) | 


B Open a recent transform 


Open a recent transform file (.mst) 


(=) Open an existing transform 
Open an existing transform file (.mst) 


@ InstallShield on the Web 
Explore InstallShield's Internet resources 


O Reload the last project saved when restarting InstallShield Tuner 
O Make this my default InstallShield Today Screen 
®© Make Welcome my default InstallShield Today Screen 


< i 


From this View, you can perform the following tasks: 


m To open a transform file, select a transform file and click Open. 


= To view information on the transform file, select a transform file and click Properties. The Properties dialog 
appears, listing details about the base MSI package and associated transforms. 


= To specify the view that will appear when Tuner is started, select one of the following options: 
O Reload the last project saved when restarting InstallShield Tuner 
O Make this my default InstallShield Today Screen 
O Make Welcome my default InstallShield Today Screen 
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Creating Generic Transforms 


Most transforms are tied to a specific product code, meaning they can only be applied to a specific version of a 
product. Generic transforms, however, do not have that limitation. They can be created to apply to multiple versions 
of a Windows Installer package (for example, Office XP and Office 2000), or to any Windows Installer package. 


gi* 
2 


Bi 


To create a generic transform: 
8. Create a transform in Tuner as you would do normally. 


9. With the transform project open, select Transform Summary Information from the Project menu to access 
the Transform Summary Dialog. 


Transform Summary 


Summary Information 


Suppress Errors: 

when applying this transform, ignore the Following Failures: 
o j [C] Delete Missing Table 
[C] Delete Missing Row [C] Modify Missing Row 
(add Existing Table C] change Codepage 


Validation: 


Before applying this transform, verify that the database meets 
the Following conditions: 


Oo Same Lanquage g Product version is Lower 
Same Product Code [C] Product Version is Equal 
C] Same Upgrade Code [C] Product Version is Higher 


When checking the product version, use only 

O None 

© Major version Version # 
© Major and Minor Versions Version #.# 


OMajor,Minor, and Update Versions Version #.#.# 


10. When the Transform Summary Dialog appears, change the validation options to reflect how you want 
the transform applied. If you want to create a completely generic transform, deselect all validation 
options. 


One use for generic transforms is to enforce standard Add/Remove Programs information on every package installed in 
your environment. The same transform can be used to set all relevant properties. 
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Using Response Transforms 


There are two ways you can create a transform file in InstallShield Tuner: 


m The first and the most common way is to begin by creating an empty transform and then making customization by 
navigating to different views in Tuner. 


m The second way is by running the installation and then customizing various options available in each setup panel. 
The installation is only simulated and no changes take place on the user system. Tuner saves all the changes that 
the user has made on each panel of the setup in the transform. This type of transform is called a response 
transform. 


Response transforms, much like installation response files, allow you to run an existing Windows Installer-based 
installation and capture your configurations. Unlike a response file, these changes are used as a starting point for your 
new transform. 


For example, if you use Tuner to create a response transform, you might select certain features you want installed, the 
location of the installation, and company information. When the Tuner interface is opened, these values will already 
be set for your new transform file. You can then make further customizations as necessary. 


You might want to create a response transform for an installation, and then fill in your company name as the default 
name, and a specific directory for installation which is different from the one suggested by the manufacturer. Further, 
you may want to configure a specific feature, such as clip art, to not be installed. By using the familiar installation user 
interface, you can quickly make your basic customizations before using the Tuner environment to refine the 
transform. 
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Viewing Transform Properties 


To view properties of the transform you are currently creating or editing, select Properties from the File menu. To 
view the properties of a project from the Open a Recent Transform View, select the transform file and click 
Properties or selecting Properties from the context menu. 


The resulting Properties dialog provides information about the transform, including the name and location of the base 
Windows Installer file, and any additional transforms that are associated with this transform and MSI file. 


Properties 


General K 


oh PackageForTheWeb 4.mst 


Location: C:\AdminStudio Shared 
Size: 3.50KB (3584 bytes) 
Base MSI: = C:\AdminStudio Shared\PackageForTheWeb 4.msi 


Created: Wednesday, July 16, 2003 11:10:39 AM 
Modified: Wednesday, July 16, 2003 11:10:39 AM 
Accessed: Wednesday, July 16, 2003 


Additional Transforms: 


InstallShield Software Corporation © 2004 368 


AdminStudio 5.5 User Guide 9 Customizing Packages 


Validation 


What is Validation? 


Validation is the process of comparing an Windows Installer-based installation to a known set of guidelines (an 
evaluation file) to ensure it has been created to those guidelines. Tuner can perform two types of validations: 
prevalidation and postvalidation. 


E Prevalidation compares only the base Windows Installer package to an evaluation file. This ensures that, when 
starting a customization project, the initial file was created using the guidelines in that evaluation file. If it does not 
pass prevalidation, then the installation may work fine, but it may not be able to use all Windows Installer features. 


E Postvalidation compares the base Windows Installer package and the changes made in a customization project 
against an evaluation file. In this case, the combination of the initial file and the subsequent modifications of the 
transform can produce different results than a comparison of just the base Windows Installer package. If the initial 
file was valid and postvalidation fails, the problems exist in the customization project. In some situations, 
advanced users may be able to use a transform file to make an initially invalid MSI file valid in conjunction with 
the transform. 


What Do You Validate Against? 


Tuner provides two files that you can validate against: the Windows 2000 Logo Program Suite and the Full MSI 
Validation Suite. 


= The Windows 2000 Logo Program Suite is a subset of the Full MSI Validation Suite, and is used to certify that 
the installation meets the Microsoft standards for the Windows logo. 


m The Full MSI Validation Suite is used to ensure that the installation meets all MSI standards. 


Validation Procedure 
Follow this procedure when validating an installation: 


E In practice, you should prevalidate the base MSI file to ensure compliance to MSI standards before you begin 
creating a customization project. 


m After you have finished your project, postvalidate it to make sure it is still compliant. 


m If the base installation was compliant and the postvalidation fails, go back to the changes you made to determine 
what caused the validation problems. 


For full details, consult the Windows Installer Help, available from the Help menu. 
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Prevalidating Windows Installer Packages 


Prevalidation compares only the base Windows Installer package to an evaluation file. This ensures that, when starting 
a customization project, the initial file was created using the guidelines in that evaluation file. 


Performing a Prevalidation 


git 


Bi. 
To prevalidate a Windows Installer package: 


1. After creating a new transform file and specifying the base Windows Installer package, select the 
Prevalidation view from the checklist. The Prevalidation View appears, listing the name of the base 
Windows Installer Package. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner DAR) 


| File Edit Yiew Go Project Tools Help 


|peHa@a|DlD|\t+e>|Bart|\SGOLU!\e@ 


Prevalidation #4 
5- Package validation 
Prevalidation Installer Package: C: AdminStudio Shared\AcroPro.msi 
S-E Organization 
Product Properties 
Features 


=) (& System Configuration Evaluation File: Full MSI Validation Suite v | Browse 
Files and Folders 
- Aa Icestorun [A | 
Registry 


3 C] Show "INFO" messages [¥] Show "WARNING" messages [¥] Show "ERROR" messages 
NT Services 
3 ODBC Resources < 
5- Application Configuration 
g Server Locations 
[E] Setup Properties 
É Dialogs To configure validation, first select the evaluation (.cub) file you want to validate 
Ea) Add/Remove Programs against, or click Browse to locate it. For best results, use the full logo-compliance 
5- Package Preparation evaluation files. Although you can enter individual Internal Consistency Evaluators (ICEs) to validate 
Postvalidation (separated by semicolons), it is best to evaluate all of them (All). 
R Package 
B- Additional Tools You can select the level of information you want to display in the Output window by checking the Info, 
im Direct Editor Warning, or Error check boxes. If the output has any error messages, it fails validation. 


¥alidation 


Once you begin validation (either by clicking the MSI Validation or Transform Postvalidation toolbar 
buttons), the results are displayed in the Output window. 


NUM 
2. Specify or browse to the Evaluation File you want to use. 


3. If you want to run specific Internal Consistency Evaluators (ICEs), specify them in the ICEs to Run text 
box, separating them by semicolons if there are more than one (for example, ICEO7;ICE13;ICE72). 
Otherwise, all ICEs are used. 


4. Specify the result level by checking the Show "INFO" messages, Show "WARNING" messages, 
and/or Show "ERROR" messages check boxes. It is highly recommended that you check at least the 
Error check box so you are certain you are not suppressing results that occur in invalid packages. 
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5. Click the MSI Validation Ee] button on the toolbar, or click the Start button in the view. 


Viewing the Prevalidation Results 


As each ICE is run, Errors, Warnings, and Info messages are generated, and are listed in the Output tab at the bottom 
of the interface. 


x) |Validation started at 8/12/2003 1:07:57 PM ... 
_Sloriginal Msi file - C:\AdminStudio Shared\AcroPra.msi 


ERROR Invalid Filename; Table: File, Column: FileName, Key(s); esdupdate.dll 

WARNING Component: Distiller_Win_NT_System_Files is a non-permanent system component 

WARNING Component: Distiller_Win9X_System_Ffiles is a non-permanent system component 

WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 

WARNING Component: AdobePS_W9xX_ChineseT_Sys is a non-permanent system component 

WARNING Component: AdobePS_W9x%_ChineseS_Sys is a non-permanent system component 

WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 

WARNING Component: Distiller_PPD_Sys_Roman_9xX is a non-permanent system component 

WARNING Component: AdobePS W9X English Sys is a non-permanent system component (Mi) 
$ i | > 


\, Output Á Validation A Packaging / 


Upon completion of the Prevalidation, the Validation tab is automatically selected, and all of the Errors, Warnings, 
and Info messages that were generated are listed in table format. Each table row lists an icon to indicate whether it is 


an Error © Warning A or Informational message “¥, the name of the ICE that generated it, and a brief description 
of what caused it to occut. 


Type Description 

ERROR Invalid Filename; Table: File, Column: FileName, Key(s); esdupdate.dll 

WARNING Component; Distiller_Win_NT_System_Ffiles is a non-permanent system component 
WARNING Component: Distiller_Win9X_System_Files is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X is a non-permanent system component 


| 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. 
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FS) Tables 
E _ Validation 
Fa ActionText 


E] AdminExecuteSequer _ 


E AdminUIsequence 


E AdvtExecuteSequenc 


E AdvtuISequence 
E] Appid 

E AppSearch 
Fal AppsInUse 
E BBControl 
E Billboard 
E Binary 

E] BindImage 
E ccPSearch 
E] checkBox 
E class 

E] ComboBox 


a 
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Direct Editor l 


Component -s72 |Componentid - $38 |Directory_-s?2 Aiz Conditi ^ 


Elements_Bin_EXE {DD4379F6-6D8E-4367- | ELEMENTS 
Elements_Bin_Update {26EB60EE-5857-4145-f ELEMENTS 
Elements _Help_Englis {49B39A88-7C40-4E14- HELP_ENU 
Elements_MFC42 {6E2D8031-BA14-4482-1 SystemFolder 
ae eee) (6 76ED632-3CD7-4B44- INSTALLDIR 
Elements_UnicowDll {47523907-B94D-4C69- ELEMENTS 
ebook_ActiveX_GBDe {8ED34EF7-70FB-4057-) ACTIVEX 
eBook_Exchange_EDt {35044EDD-DO70-484F- ACROBAT 
Plugins_eBook {56454F03-FC42-4600-, PLUG_INS 
eBook_Exchange_EDE {77ED68FF-1873-47B8-! ACROBAT 
Plugins_PreFlight_Utili {2676139B-729C-4EFD-, PLUGINS _PREFLIGH’ 0 
Plugins_PreFlight {70947044-DA38-434D- PLUGINS_PREFLIGH’ 0 
PDFMakerx {7D445966-3545-42EF-f PDFMAKER_COMMO| 0 
PDFMakerx_Tlb {F78814EA-CAF5-4983- PDFMAKER_COMMO 0 
PDFMaker_TTFont {F5EC244B-114F-4469-, FontsFolder 
Scan_Windows Files {4EC18029-40C8-469A- WindowsFolder 
Resources_English | {B4E6E529-0648-48D5-) RESOURCE 


CaramanDeceweeDEh J272FRAFN.0CFA-4REA. EORIT DEM 


Version 


m (Not(Pron 


(Version? 


Product 
Product¢ 


(Version? 


This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows 


Installer package and store them in your transform. For more information, see Direct Editor. 


(| K) — 


If no errors appear in the results (providing you are displaying errors), then the package is valid against the specific 
ICEs you specified, or against the entire evaluation file (if no ICEs were selected). 


Handling Invalid Windows Installer Packages 


Ideally, all Windows Installer packages will pass validation. Realistically, many will fail (generating errors). When a 
package fails validation, it means the package was not built to Microsoft's specifications. It does not mean the 
installation does not work. Although However, there are a few things you can do when your package has validation 


errors: 


Solution 


Explanation 


Use Tuner to correct 
validation errors. 


This involves opening the base package using Tuner and creating a transform file which 
contains your corrections. 


vendor. 


Contact the installation 


The company that created the installation (usually the same company that created the 
software) may be able to resolve the validation issues and provide you with a valid setup. Be 
sure to provide the validation report to vendors so they know where to focus. 


application. 


Reconsider using the 


Although it might be an extreme reaction to an invalid package, there may be compelling 
reasons not to use an installation not built to Microsoft guidelines. 


install anyway. 


Ignore the problems and 


This is probably the most likely scenario. The invalid installation may not be worth trying to 
fix, or even have errors that you are concerned about. You could proceed and just use the 
installation as it is. From a practical standpoint, this may be your best option. 
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Most packages will also generate Warnings during validation. These can occur in valid packages, and many cannot 
be removed. Although the presence of Warnings does not make a package invalid, it is generally a good practice to 
eliminate Warnings (if possible). 


Posivalidating Transforms 


To postvalidate a Windows Installer package and the transform you are creating: 


1. Select the Postvalidation view from the checklist. The Postvalidation view appears, listing the name of 
the base Windows Installer Package. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner DAR) 
| 


| Eie Edit Yiew Go Project Tools Help 


joeug|/DD|t+e>|Baxr OSL! \e@ 


Postvalidation 3 
(=) Package Validation 
Prevalidation Installer Package: C^ AdminStudio Shared\\AcroPro.msi 
B- Organization 
Product Properties 
D Features 


=) System Configuration Evaluation File: Full MSI Validation Suite Browse 
Files and Folders 
A ICEs to Run: all Start 
Registry 


Shortcuts 
a INI Files C] Show "INFO" messages Show "WARNING" messages Show "ERROR" messages 


NT Services 
ODBC Resources 
B- Application Configuration 
g Server Locations 
[0] Setup Properties 
m Dialogs 
á © AaddiRamove Programs To configure validation, first select the evaluation (.cub) file you want to validate 
B- Package Preparation 


¥alidation 


Postvalidation against, or click Browse to locate it, For best results, use the full logo-compliance 

ostvallc uon . yo, . . o . . 
PE Š evaluation files. Although you can enter individual Internal Consistency Evaluators (ICEs) to validate 
tS aE (separated by semicolons), it is best to evaluate all of them {All}. 


Direct Editor ; ; ; : ; ; 
You can select the level of information you want to display in the Output window by checking the Info, 
Warning, or Error check boxes. If the output has any error messages, it fails validation. 


Once you begin validation (either by clicking the MSI Validation or Transform Postyalidation toolbar 
buttons), the results are displayed in the Output window. 


2. Specify or browse to the Evaluation File you want to use. 


3. If you want to run specific Internal Consistency Evaluators (ICEs), specify them in the ICEs to Run text 
box, separating them by semicolons if there are more than one (for example, ICEO7;ICE13;ICE72). 
Otherwise, all ICEs are used. 
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4. Specify the result level by checking the Show "INFO" messages, Show "WARNING" messages, 
and/or Show "ERROR" messages check boxes. It is highly recommended that you check at least the 
Error check box so you are certain you are not suppressing results that occur in invalid packages. 


5. Click the Transform Validation 4” button on the toolbar, or click the Start button in the view. 


Viewing the Postvalidation Results 


As each ICE is run, Errors, Warnings, and Info messages are generated, and are listed in the Output tab at the bottom 
of the interface. 


x) |Validation started at 8/12/2003 1:07:57 PM... 
zÍ Original Msi File - C:\AdminStudio Shared\AcroPra.msi 


ERROR Invalid Filename; Table: File, Column: FileName, Key(s): esdupdate. dll 

WARNING Component: Distiller_Win_NT_System_files is a non-permanent system component 

WARNING Component: Distiller_Win9x_System_Ffiles is a non-permanent system component 

WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 

WARNING Component: AdobePS_W9xX_ChineseT_Sys is a non-permanent system component 

WARNING Component: AdobePS_W9xX_ChineseS_Sys is a non-permanent system component 

WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 

WARNING Component: Distiller_PPD_Sys_Roman_9xX is a non-permanent system component 

WARNING Component: AdobePS W9X English Sys is a non-permanent system component Mi 
ill | > 


\ Output Á Validation A Packaging / 


Upon completion of the Postvalidation, the Validation tab is automatically selected, and all of the Errors, Warnings, 
and Info messages that were generated are listed in table format. Each table row lists an icon to indicate whether it is 
an Error © Warning å, or Informational message 4, the name of the ICE that generated it, and a brief description 
of what caused it to occur. 


x KE Type Description A| 
z F : z = 
ERROR Invalid Filename; Table: File, Column: FileName, Key{s): esdupdate.dll 

WARNING Component: Distiller_Win_NT_System_Files is a non-permanent system component 
WARNING Component: Distiller_Win9x_System_Ffiles is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X is a non-permanent system component as 
ii | >| 
J Validation Á Packaging j 
Ready NUM 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. 
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This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows 
Installer package and store them in your transform. For more information, see Direct Editor. 


If no errors appear in the results (providing you are displaying errors), then the package and transform are valid 
against the specific ICEs you specified, or against the entire evaluation file (if no ICEs were selected). 


It is possible for a package that passed the prevalidation to fail the postvalidation. Remember changes made in the 
Setup Properties can affect your installation. If your package fails postvalidation, check all changes made in the Setup 
Properties for accuracy. To identify the original Setup Properties, you can create a new transform file that can be 
deleted at any time. Changes made using the Direct Editor can also affect your installation's functionality. 


Evaluation Files and Internal Consistency 


Evaluators 


When you prevalidate the base Windows Installer package, or postvalidate the package and your transform, Tuner 
runs several Internal Consistency Evaluators (ICEs) contained in the specified evaluation file. If the base package or 
your transform and package does not pass one of these ICEs, Tuner reports the failure. If the problem is in the base 


package, you can contact the software vendor to report the problem. 
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The Organization View allows you to modify two main parts of the installation that your end users will see: the 
default path and default company name, and the actual features that can, will, or will not be installed. 


PackageFor TheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 
| Eie Edit view Go Project Tools Help 
joGu@|DD|t++>|Bax\OSL!\e@ 


® Organization 


InstallShield Toda’ . . 
tae ” Organization 
B- Package validation 
E Prevalidation Organize your setup to make development easier, and to allow your users to 
Sim] Organization | customize which parts of your application they install. 
Product Properties 
H Features 
4 System Configuration 


p Product Properties 
9 Files and Folders Specify the default directory for installation, the default organization name, 


Registry and the default destination variable. 
Shortcuts 


INI Files 
NT Services Features 
ODBC Resources Configure the description, initial state, and visibility for each feature.in the 
2-6 Application Configuration Windows Installer package. 
g Server Locations 
[E] Setup Properties 
É Dialogs 
Ea) Add/Remove Programs 
5- Package Preparation 
Postvalidation 
Package 
©) Additional Tools 
E] Direct Editor 


aif MSI Validation A Transform Validation A Packaging A Output 7 
x 


Ready | NUM 
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Changing a Feature's Visibility 


To change the visibility of a feature: 


1. Under Organization in the checklist, select the Features View. This project's Features are listed in the 
second column. 


Orca1.mst (Orca.msi) - InstallShield Tuner 


| Ble Edit View Go Project Tools Help 


jpeu@|DD|t+e> | Bax |OSL!\e@ 


w Features 


4@ InstallShield Today 
@) Help 
5- Package Validation 
E Prevalidation 
B- Organization 
Product Properties 


(Features | 


4 System Configuration 
Files and Folders 
Registry 
Shortcuts 
a INI Files 
ey NT Services 
a9 ODBC Resources 
a © Application Configuration 
a Server Locations 
[E] Setup Properties 


E Dialogs 


B Add/Remove Programs 


4 Package Preparation 


Postvalidation 
# Package 
EM Additional Tools 
Direct Editor 


Features 
=) @) Orca For Windows 


©) Merge Module Support 


©) Run Time Libraries 


@) MSI Validation Support 


E- validation Data 


Features 
5- Orca for Windows 
i) Merge Module Support 
Œ) Run Time Libraries 
@) MSI Validation Support 
#4 D validation Data 


Description 
visible 
Initial State 
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Run Time Libraries 
C Run Time and Microsoft Foundation Classes, 


Features are the building blocks of an 
installation from an end user's perspective. 

They represent a specific capability of the product—such as its 
help files or a part of a product suite—that can be installed or 
uninstalled based on the end user's selections. Features can be 
composed of subfeatures, which in turn can be composed of 
further subfeatures. Depending on the visibility of the "parent" 


feature, end users can select which portions of a feature to 
install in the Custom Setup dialog. 


Each feature and subfeature has properties that can be 
modified within Tuner, These include the feature's description 
(as it appears in the Custom Setup dialog), its visibility, and its 
initial state (not installed, installed locally, run from source, or 
advertised). Tuner allows you to change these feature 
properties to best suit your situation, For example, you may 
want to prevent a specific application within a suite from being 
installed. By changing its initial state and visibility, you can 
prevent your end user from ever seeing this feature during 
installation. 


2. Select the feature that you would like to change the visibility on. The Properties for that feature are 
listed. 


visible andExpanded CRY 


stalled on the local drive. 
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3. Click in the Visible property in the Feature Properties grid and make a selection from the drop-down 
menu. Your options are: 


Option Description 
Not Visible The feature will not show up in the custom setup dialog during installation. 
Visible and Expanded The feature will be displayed with all its subfeatures visible in the custom setup 


dialog during installation. 


Visible and Collapsed The feature will be displayed in a collapsed state in the custom setup dialog 
during installation. 


Setting the Initial State of a Feature 


To set the Initial State of a feature: 


1. Under Organization in the checklist, select the Features view. This project's Features are listed in the 
second column. 


Orca1.mst (Orca.msi) - InstallShield Tuner 
| Ble Edit View Go Project Tools Help 


*¢¢5|Hax4x|OS7!\e@| 


w Features 


$Ê InstallShield Today ) Features 
©) Help =) GY Orca for Windows 


© ( Package Validation E) Merge Module Support Features are the building blocks of an 


Prevalidation ® Run Time Libraries installation from an end user's perspective. 


(ai) Organization i F D mor haath Support They represent a specific capability of the product—such as its 
Product Properties ® @ Validation Data help files or a part of a product suite—that can be installed or 
La) Features | uninstalled based on the end user's selections, Features can be 

composed of subfeatures, which in turn can be composed of 


further subfeatures. Depending on the visibility of the "parent" 


4 System Configuration 
B) Files and Folders 


E Registry feature, end users can select which portions of a feature to 


Shorteuts install in the Custom Setup dialog. 
INI Files 


ey NT Services 
ODBC Resources Each feature and subfeature has properties that can be 


S- Application Configuration modified within Tuner, These include the feature's description 
a Server Locations (as it appears in the Custom Setup dialog), its visibility, and its 
[E] Setup Properties initial state (not installed, installed locally, run from source, or 
E Dialogs advertised). Tuner allows you to change these feature 
a) Add/Remove Programs properties to best suit your situation. For example, you may 

=) Package Preparation want to prevent a specific application within a suite from being 

Postvalidation installed. By changing its initial state and visibility, you can 

R Package prevent your end user from ever seeing this feature during 


B- Additional Tools installation. 
E] Direct Editor 
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2. Select the feature that you would like to change the initial state of. The Properties for that feature are 


listed. 


9 Features Run Time Libraries 


=) @Y Orca for Windows Description C Run Time and Microsoft Foundation Classes. 
©) Merge Module Support Visible Visible and Expanded 
©) Run Time Libraries Initial State 


@) MSI Validation Support 
H- Validation Data 


Click in the Initial State property in the Feature Properties grid and choose one of the selections from the 
drop-down menu. Your selections are: 


m The feature is not installed: By default, the feature will not be installed during setup. 


m The feature is installed on the local drive: By default, the feature will be installed on the local 
drive during setup. 

m The feature is run from source, CD, or the network: By default, the feature will be run from 
the source, whether it be from the installation CD or from the network. 

m The feature is advertised: By default, the feature will be advertised, but not installed. Essentially, 
this is an on-demand option; a shortcut will be created during setup, and if the shortcut is clicked, the 
feature will then be installed from the source. This ensures features that may be unnecessary are not 
installed until they are needed, if ever. For more information, see Feature Advertisement. 


The initial default settings run the Setup in a quiet mode. 
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Editing a Feature's Description 


To edit a feature's description: 


1. Under Organization in the checklist, select the Features view. This project's Features are listed in the 


second column. 


Orca1.mst (Orca.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


æ Features 


40% InstallShield Today 
@) Help 
4 Package Validation 
Prevalidation 
B- Organization 
Product Properties 
© 
B- System Configuration 
B) Files and Folders 


a Registry 
Shortcuts 
INI Files 


NT Services 
ODBC Resources 
5- Application Configuration 
a Server Locations 
[E] Setup Properties 
E Dialogs 
i B Add/Remove Programs 
2 Package Preparation 


Postvalidation 
z Package 
5- Additional Tools 
Direct Editor 


J Features 


PEACE- om] +t $+> |Bax|Osy TET 


Features 
5- Orca for Windows 
@) Merge Module Support 
® Run Time Libraries 
@) MSI Validation Support 
@) Validation Data 


Features are the building blocks of an 
installation from an end user's perspective. 

They represent a specific capability of the product—such as its 
help files or a part of a product suite—that can be installed or 
uninstalled based on the end user's selections. Features can be 
composed of subfeatures, which in turn can be composed of 
further subfeatures. Depending on the visibility of the "parent" 
feature, end users can select which portions of a feature to 
install in the Custom Setup dialog. 


Each feature and subfeature has properties that can be 
modified within Tuner. These include the feature's description 
(as it appears in the Custom Setup dialog), its visibility, and its 
initial state (not installed, installed locally, run from source, or 
advertised), Tuner allows you to change these feature 
properties to best suit your situation. For example, you may 
want to prevent a specific application within a suite from being 
installed, By changing its initial state and visibility, you can 
prevent your end user from ever seeing this feature during 
installation, 


2. Select the feature that you would like to change the description of. The Properties for that feature are 
listed. 


Run Time Libraries 


=) Ls) Orca For Windows Description 
2 Merge Module Support Visible 
©) Run Time Libraries Initial State 
©) MSI Validation Support 
H- Validation Data 


w 
C Run Time and Microsoft Foundation Classes.| N 
visible and Expanded 

The feature is installed on the local drive, 


3. Click in the Description property in the Feature Properties grid. 


4. Enter the new feature description in the Description value cell. 
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To specify the Default Destination Path for an installation: 


1. Under Organization, select the Product Properties view from the checklist. The Product Properties view 


appears. 


PackageForTheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 
| Bile Edit View Go Project Tools Help 
j>GH@#|DD|\t+e> | Bar |OSL!\e@ 


H Product Properties 


gÊ InstallShield Today Product Properties 
@) Help Property ¥Yalue 
S- Package validation Default Destination Variable INSTALLDIR 
E Prevalidation Default Destination Path ProgramFilesFolder\InstallShield\PackageForTheweb 4 
(=j © Organization Company Name 
i) Features 
S- System Configuration 


Files and Folders T F 
f Default Destination Yariable 
Registry 


Shortcuts 
a This is the variable in which the Default Destination Path is stored. If you change 


INI Files 

Sa NT Services 

= ODBC Resources 

S Application Configuration 
g Server Locations , 2 . . _ 
E Setup Properties Reset | This button resets the Default Destination behavior to its original (base MSI) 
E Dialogs value, 
Ea) Add/Remove Programs 

=) Package Preparation 

Postyalidation 

z Package 

S- Additional Tools 
E] Direct Editor 


its value, it may cause adverse affects on the installation. For full information, 
please refer to the Default Destination and Organization online help topic. 


2. Click in the Default Destination Path property in the Product Properties grid. 


3. Provide the path that you want to use as the Default Destination Path. 


Consult the Product Properties help topic for important information about the Default Destination Variable and how it 


can be affected by changing this value. 
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Setting the Default Organization 


To specify the default organization for the installation: 


1. Under Organization, select the Product Properties view from the checklist. The Product Properties View 
appears. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 
|| File Edit Yiew Go Project Tools Help 
jaeu@/DD|\t+e>+\BaX|OSL!\e@ 
H Product Properties 


gf} InstallShield Today Product Properties 
@) Help Property ¥alue 
I Package validation Default Destination Variable INSTALLDIR 


Prevalidation Default Destination Path ProgramFilesFolder\InstallShield\PackageForThewWeb 4 
5- Organization Company Name 

Product Properties 

5] Features 
B- System Configuration 

iP} Files and Folders TEF z 

` Default Destination Yariable 
g Registry 


Shortcuts 
INI Files This is the variable in which the Default Destination Path is stored. If you change | Give Us Feedback 


NT Services its value, it may cause adverse affects on the installation, For full information, 
ODBC Resources please refer to the Default Destination and Organization online help topic. 
5- Application Configuration 
g Server Locations 


[E] Setup Properties Reset | This button resets the Default Destination behavior to its original (base MSI) 
É Dialogs value. 


Ea Add/Remove Programs 
5- Package Preparation 


Postvalidation 
# Package 
5- Additional Tools 
E] Direct Editor 


Ready 


2. Click in the Company Name property in the Product Properties grid. 


3. Enter the name you want to use as the default organization name. The organization name can be a 
maximum of 30 characters in length. 
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Changing the Destination Variable 


To specify the Destination Variable that holds the Default Destination Path: 


1. Under Organization, select the Product Properties view from the checklist. The Product Properties view 
appears. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 
|| File Edit Yiew Go Project Tools Help 
jaeu@/DD|\t+e>+\BaX|OSL!\e@ 
H Product Properties 


gf} InstallShield Today Product Properties 
@) Help Property ¥alue 
4 Package Validation Default Destination Variable INSTALLDIR 
Prevalidation Default Destination Path ProgramFilesFolder\InstallShield\PackageForThewWeb 4 
& B Organization Company Name 
5] Features 
B- System Configuration 
iB} Files and Folders ae 7 
` Default Destination Yariable 
g Registry 


Shortcuts 
INI Files This is the variable in which the Default Destination Path is stored. If you change 
NT Services its value, it may cause adverse affects on the installation. For full information, 
ODBC Resources please refer to the Default Destination and Organization online help topic. 
5- Application Configuration 
g Server Locations i ae , . a 
[E] Setup Properties Reset | This button resets the Default Destination behavior to its original (base MSI) 
om Dialogs value. 
Ea Add/Remove Programs 
5- Package Preparation 


Postvalidation 
Package 


5- Additional Tools 
E] Direct Editor 


Ready 


2. Click in the Default Destination Variable property in the Product Properties grid. 


gÊ InstallShield Today tals Product Properties 
@) Help Property ¥Yalue 
=) Package validation Default Destination Yariable INSTALLDIR v 
Prevalidation Default Destination Path ProgramFilesFolder\InstallShield\PackageForTheWeb 4 
=] © Organization Company Name 
Product Properties 
2) Features 


3. Select the Default Destination Variable you want to use from the drop-down menu. 


Consult the Product Properties help topic for important information about this variable. 
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Preventing Features from Displaying During 
Custom Installation 


To prevent a feature from being displayed to your end users during a custom 
installation: 


1. Under Organization in the checklist, select the Features View. This project's Features are listed in the 
second column. 


Orca1.mst (Orca.msi) - InstallShield Tuner 
|| Eile Edit Yiew Go Project Tools Help 
joenes Dmt tes mas OSL! \o@ 


w Features 


4@ InstallShield Today 
@) Help 


9 Features 
5- Orca for Windows 


5- Package Validation ® Merge Module Support 
Prevalidation ©) Run Time Libraries 

4 Organization 2 MSI Validation Support 
Product Properties 8 @Y validation Data 


(Features | 


4 System Configuration 
Files and Folders 
Registry 
OEY Shortcuts 
3 INI Files 
Sey NT Services 
ODBC Resources 
4 Application Configuration 
Server Locations 
[E] Setup Properties 
} Dialogs 
Fa) Add/Remove Programs 
=] © Package Preparation 
Postvalidation 
# Package 
B- Additional Tools 
E] Direct Editor 


Features are the building blocks of an 


installation from an end user's perspective. 

They represent a specific capability of the product—such as its 
help files or a part of a product suite—that can be installed or 
uninstalled based on the end user's selections. Features can be 
composed of subfeatures, which in turn can be composed of 
further subfeatures. Depending on the visibility of the "parent" 


feature, end users can select which portions of a feature to 
install in the Custom Setup dialog. 


Each feature and subfeature has properties that can be 
modified within Tuner, These include the feature's description 
(as it appears in the Custom Setup dialog), its visibility, and its 
initial state (not installed, installed locally, run from source, or 
advertised). Tuner allows you to change these feature 
properties to best suit your situation, For example, you may 
want to prevent a specific application within a suite from being 
installed. By changing its initial state and visibility, you can 
prevent your end user from ever seeing this feature during 
installation. 


2. Select the feature that you would like to hide. The Properties grid for that feature appears. 


Features 
= @) Orca For Windows 

©) Merge Module Support 

©) Run Time Libraries 

@) MSI Validation Support 
H- Validation Data 


Description 
Visible 
Initial State 


Run Time Libraries 
C Run Time and Microsoft Foundation Classes. 


[visible and Expanded Mi | 


The Feature is installed on the local drive. 


3. Click in the Visible property in the Properties grid and select Not Visible from the drop-down menu. 


The feature selected will not be visible during custom installation. Depending on the feature's Initial State, the feature 


may or may not be installed on the end user's system. 
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Setting Feature Properties 


ome 
8, 
To set Feature Properties: 


1. Select Features under Organization in the checklist. 


2. Select the Feature that you want to edit. The Feature Properties view appears. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 
| File Edit Yiew Go Project Tools Help 
|DGH@#|DD|*t+e> | Bax OSL! \O@ 


w Features 


4% InstallShield Today W Features PackageForTheWeb4NewFeature 
©) Help Æ) PackageForTheWeb¢NewFeature Description PackageForTheWeb4NewFeature 
S- Package Validation i) NewFeaturel Visible Visible and Collapsed 
EA Prevalidation Initial State The feature is installed on the local drive. 
S- Organization 
Product Properties 
B Features 
4 System Configuration 
Q Files and Folders Description 
W Registry 


E Shortcuts This property contains a description that will be ( Give Us Feedback ) 
-$ INI Files displayed when a feature is clicked in the Custom 


NT Services Setup dialog during installation. 
=f) ODBC Resources 


S- Application Configuration 
a Server Locations 
[E] Setup Properties 
E} Dialogs 
£ D Add/Remove Programs 
Z} om] Package Preparation 


Postvalidation 
Package 


S- Additional Tools 
E] Direct Editor 


3. In the Description text box, enter a description that will be displayed when a feature is clicked in the 
Custom Setup dialog 


4. From the Visible drop down list, select an option to specify how the feature is presented to the end user 
in the Custom Setup dialog. The following options are available: 


a Visible and Collapsed: The feature will be displayed in the Custom Setup dialog with its 
subfeatures collapsed by default. 


a Visible and Expanded: The feature will be displayed in the Custom Setup dialog with its 
subfeatures expanded by default. 


m Not Visible: The feature will not be displayed to the end user in the Custom Setup dialog. 


Although an end user obviously cannot select or deselect an invisible feature, this property does not 
have any direct bearing on whether a feature is installed. In other words, a feature is not automatically 
installed if it is invisible; it just cannot be deselected if it would otherwise be installed, or selected if it 
should not be installed. 
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5. From the Initial State list, select an option to determine how (or if) the feature is installed during 
installation: 


m The feature is not installed (INSTALLSTATE_ABSENT): The feature will not be installed during 
setup. 


m The feature is installed on the local drive (INSTALLSTATE_LOCAL): The feature will be 
installed on the local drive during setup. 

= The feature is run from source, CD, or network (INSTALLSTATE_SOURCE): The feature will 
be run from the source, whether it is from the installation CD or from the network. 

= The feature is advertised (INSTALLSTATE_ADVERTISED): The feature will be advertised, but not 
installed. Essentially, this is an on-demand option; a shortcut will be created during setup, and if the 
shortcut is clicked, the feature will then be installed from the source. This ensures features that may be 
unnecessary are not installed until they are needed, if ever. For more information, see Feature 
Advertisement. 


Using Feature Advertisement 


Windows Installer supports many features of Windows 2000 and later platforms, including feature advertisement. 
This convenience enables any product feature to be in one of four installation states: 


The feature is not installed 

The feature is installed on the local drive 

The feature is run from source, CD, or the network 
The feature is advertised 


When features are advertised, they are not actually installed on the local system. However, they appear to be, in that 
the appropriate shortcuts to launch the feature are present. The first time a user attempts to use a feature that is 
advertised, it is installed on the computer. 


Feature advertisement is fully supported only on the Windows XP, Windows 2000, and Windows Me operating 
systems, though an updated shell is available for Windows 95, Windows 98, and Windows NT 4.0. To activate the 
shell for any of these platforms, Microsoft's Internet Explorer 4.01 Service Pack 1 must be installed and Active 
Desktop enabled. 


For instructions on how to specify feature advertisement and the other installation states of a feature, see Setting the 
Initial State of a Feature. 
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Configuring Package Content 


Many modifications you can make in a transform file involve manipulating the original package contents. This 
includes files and folders, registry data, shortcuts, INI files, ODBC resources, and NT services. 


Files and Folders 


From the Files and Folders view, you can perform all file operations in Tuner. This includes viewing files in the 
source MSI package, adding new files, preventing files from being installed, and removing added files. 


Adding Files 


To add files to an installation: 


1. Select the Files and Folders view from the checklist. The Files and Folders View appears. 


Paint Shop Pro 7 Anniversary Edition.mst (Paint Shop Pro 7 Anniversary Edition.msi) - InstallShie... 
| File Edit view Go Project Tools Help 
|\Dpeba|DlD|t+e>+\Bax|eG.! \e@ 

B Files and Folders 


Åt InstallShield Today Source computer's directory tree Source computer's files 
@) Help ; 
5- Package Validation az Size Type 
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g Registry 


OEY Shortcuts 
a INI Files 
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ODBC Resources Destination computer's folders Destination computer's files 
4 Application Configuration W Destination Computer 
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S- Package Preparation {© WindowsFolder 
Postvalidation 
R Package 
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E Direct Editor 


Name Size 
readme.doc 35.0 KB — 
RefColor.dat 17.4 KB 
pspud.flt 251 bytes 
Register.exe 138 KB 
tips.txt 15.6 KB 
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2. Navigate to the location in the Source computer's directory tree that contains the file you want to add. 


3. Select the file you want to add from the Source computer's files pane. 
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4. Drag the file to the appropriate folder in the Destination computer's folders tree. The file then appears 
in the Destination computer's files pane, with an icon indicating that it is an added file. 


L) RefColor,dat 

7 File was added to 
A) readme2.doc 4+- installation. 

P readme.doc 


Displaying Files from the Base Windows Installer Package 
oie 


Bi 


To display files from the base Windows Installer package in the Files and Folders view: 
1. Select Options from the Tools menu to display the Options Dialog. 


2. Select the View Settings tab. The Option Dialog's View Settings pane opens. 


Options 


File Locations View Settings 


Files View 


3. Select the Display files from the original MSI package in addition to files added in the transform check 
box. 
4. Click OK. 


When you return to the Files and Folders view, all files from the base Windows Installer package are 
displayed as well as the files added in the transform. 
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By default, this option is enabled. 


Preventing Installation of Files from the MSI 


To prevent files from the base Windows Installer package from being installed: 


1. Select Files and Folders from the checklist. The Files and Folders View opens. 
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SI © Package Validation = Poskok Size Type 
FZ) Prevalidation as My Computer 
È- Organization = My Network Places 
Product Properties = si sad la 
Features 
4 System Configuration 
Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources Destination computer's Folders Destination computer's Files 
B- Application Configuration 
a Server Locations 
[E] Setup Properties 
E Dialogs 
Ea) Add/Remove Programs 
=) Package Preparation 


Postvalidation 
8 Package 
S- Additional Tools 
E] Direct Editor 


Destination Computer 
S- ProgramFilesFolder 
B- Jasc Software Inc 
a- Paint Shop Pro 7 
(© SystemFolder 
{© WindowsFolder 


Name | Size 
readme.doc 35.0 KB 
RefColor.dat 17.4 KB 
pspud. fit 251 bytes 
Register,exe 138 KB 
tips. txt 15.6 KB 
PCache02. JDB 0 bytes 
PCache01.JDB 0 bytes 


haal Fle n nvo 
Iii 


* COCCCOCCO- 


xl MSI validation A, Transform Validation A, Packaging A Output 
Y 


Ready 


2. Navigate to the folder which contains the file in the Destination computer's folders tree that you want to 
remove from the installation. 
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3. In the Destination computer's files pane, select the file you want to prevent from being installed and 
select Remove from the context menu. 


The actual file within the Windows Installer package is not deleted—only the entry in the File table is 
removed. The icon for the file changes to a computer with a red "X" over it. 


P Register.exe 


K)  tips.txt 


_) PCache02. JDB 


If you remove a file, and later want to restore it to the installation, simply right-click the file again and 
select Restore. 


Key files in the base Windows Installer package are denoted with a key icon, and cannot be marked for deletion. 
Additionally, files contained within cabinet (.CAB) files are not displayed, and therefore cannot be marked for deletion. 
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Removing Added Files 


To remove files you have added to an installation: 


1. Select Files and Folders from the checklist. The Files and Folders View opens. 


Paint Shop Pro 7 Anniversary Edition.mst (Paint Shop Pro 7 Anniversary Edition.msi) - InstallShie... 


|| File Edit View Go Project Tools Help 


jaena@|DlD|t+e>|Baxr|eGu!\o@ 
B Files and Folders 


Ê InstallShield Today Source computer's directory tree Source computer's files 
©) Help 7 
S- Package Validation = GEI SES) V2 
EA Prevalidation Š P Emp! 


£3) Organization g 9 My Network Places 
Product Properties = My Documents 
@ Features 
4 System Configuration 
Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources Destination computer's Folders Destination computer's Files 


a B Application Configuration Destination Computer 
g Server Locations 


, B-E ProgramFilesFolder 
[E] Setup Properties B- Jasc Software Inc 
© Dialogs 


z =- Paint Shop Pro 7 
i gh Add/Remove Programs © SystemFolder 
B- Package Preparation {© WindowsFolder 
Postvalidation 
2 Package 


4 Additional Tools 
E] Direct Editor 


Name Size 
readme.doc 35.0 KB - 
RefColor dat 17.4 KB 
pspud.flt 251 bytes 
Register.exe 138 KB 
tips. txt 15.6 KB 
PCache02. JDB 0 bytes 
PCache01.JDB O bytes 


hanla Fle n nvo 
Jil 


* DDED 


x MSI validation A, Transform Validation A, Packaging A Output 
y 


Ready 


2. In the Destination computer's folders tree, navigate to the folder containing the added file that you want 
to remove. 


3. Select the file you want to remove from the Destination computer's files pane. 


InstallShield Software Corporation © 2004 391 


AdminStudio 5.5 User Guide 


4. Select Remove from the context menu or press the Delete key. 


Destination computer's files 


Size Attri... 
f210.dll 36.0 KB NEUT 
Jcm.dll 36.0 KB NEUT 


readme.doc 35,0 KB PSP_ 


Com ^ 


RefColor dat 
tips. txt 


' Copy 


| 

anim.cnt | Remove (Del) 
imen.cnt | 
| 


Properties 


Storing Added Files 


L 
- 
- 
B 
CESME eno E 
x) t y 
P 
® 
< 
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When you add files to a transform, Tuner stores them in a CAB file with the same name as your transform. The added 
files are placed in the CAB and Tuner no longer maintains a reference to the original file location on the source 
computer. If you add additional files after saving the transform, the contents of the CAB file are extracted and 


recompressed along with the new files. 


Because this mechanism relies on the presence of the CAB file, this file must be stored in the same location as the 
transform. If you move, modify, or delete the CAB file, Tuner will no longer be able to include the added files in the 
transform. You must then delete the files from the Files and Folders View and re-add them from their original 


locations, or locate the original CAB and place it back in the same folder as the transform. 


Also, because the contents of the CAB file are uncompressed and recompressed when you add subsequent files to the 


installation, you must have sufficient disk space for this extraction when you save the transform. 
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Registry Entries 


9 Customizing Packages 


You can use the Registry view to create keys and values similar to how you use the Windows Registry Editor, or you 
can copy or drag and drop existing keys and values from the Source view. 


Purther, you can use this view to import an existing REG file using the Registry Import Wizard. You can also modify 
or delete registry keys that are part of the base installation. If you add new registry keys, they will always be installed. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 


| File Edit View Go Project Tools Help 


joebH@#|DD\t+e+> | Bax~|OSL! e@ 


& Registry 


$Å InstallShield Today 
©) Help 
B- Package Validation 
EA Prevalidation 
B- Organization 
Product Properties 
a Features 
B- System Configuration 
Files and Folders 
Registry 
OJ Shortcuts 
INI Files 
NT Services 
ODBC Resources 
Application Configuration 
g Server Locations 
[E] Setup Properties 
É Dialogs 
ay Add/Remove Programs 
=) Package Preparation 


Postvalidation 
y Package 
5- Additional Tools 
Direct Editor 


MSI Validation A Transform Validation 


Source Computer Registry View 


My Computer 
®© B HKEY_CLASSES_ROOT 
E] © HKEY_CURRENT_USER 
4) AppEvents 
{© Console 
S- Control Panel 
w- Accessibility 
H- Appearance 
© Colors 
E Current 


© Cursors 


Destination Computer Registry View 


My Computer 
®© © HKEY_CLASSES_ROOT 
awa HKEY_CURRENT_USER 
®© B HKEY_LOCAL_MACHINE 
(© HKEY_USER_SELECTABLE 
© HKEY_USERS 


Source Computer Registry Data 


Name Data 
ab) (Default) (value not set) 
ab) ActiveBorder 212 208 200 
ab) ActiveTitle 084 227 
ab) App WorkSpace 128 128 128 
ab) Background 078 152 
ab) ButtondlternateFace 181 161 181 
ab) ButtonDkShadow 113 111 100 
ab) ButtonFace 236 233 216 
ra 


Destination Computer Registry Data 


Name Data 
ab) (Default) (value not set) 
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Creating a Registry Key 


To specify a registry key that will be created on the target system: 


1. Select Registry from the checklist. The Registry View opens. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 
|o ene nmt +e» masl Dono 
& Registry 


9% InstallShield Today Source Computer Registry view Source Computer Registry Data 
©) Help ; 
p. RP 1 My Computer Name Data 
=) Package Validation hs alte 
E Prevalidation o d D EA ab) (Default) (value not set) 
B- Organization ae An Events = ab) ActiveBorder 212 208 200 
Product Properties ri PP fab) ActiveTitle 084 227 


© Console 
@) Features E- Control Panel fab) AppWorkSpace 128 128 128 


ae aean conaran E- Accessibility fab) Background 078 152 
a Si-O Appearance aB) ButtondlternateFace 181 181 181 


Registry 


fab) ButtonDkShadow 113 111 100 
Shortcuts © Colors 


ButtonFace 236 233 216 
INI Files = Net a 
NT Services 
ODBC Resources Destination Computer Registry View Destination Computer Registry Data 
3- Application Configuration @ My Computer ae TE 


g Server Locations z m 
[E] Setup Properties 2 TEIE ab) (Default) (value not set) 


£ Dialogs E- HKEY_LOCAL_MACHINE 


3 £} Add/Remove Programs (©) HKEY_USER_SELECTABLE 
©) Package Preparation (© HKEY_USERS 


Postvalidation 
Package 


=) Additional Tools 
Direct Editor 


x] i MSI Validation A Transform Validation A Packaging A Output F 


2. In the Destination Computer Registry View, select the key to which you want to add a value. All existing 
values for that key in the Destination Computer Registry Data pane are displayed. 
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3. To create a subkey, select a registry hive (such as HKEY_CURRENT_USER) or an existing key, point to 
New on the context menu, and select Key. 


Destination Computer Registry 


Destination Computer Registry View 


3 My Computer 


E-E HKEY_CLASSES_ROOT 
B =m 
ty HKEY_LOCAL_MAC i 
(© HKEY_USER_SELE! Cop trl+C) tring Value 
(Gy HKEY_USERS | Paste (Ctrl+V) inary Value 


| 
| 
| 
| 
| 
| 
| 
| 
| 


Import REG File... 


A new key is created with the name "NewKeyn" (where n is a successive number). 


Destination Computer Registry View 


y My Computer 


E-E HKEY_CLASSES_ROOT 
S-E HKEY_CURRENT_USER 


B- HKEY_LOCAL_MACHINE 
S- SOFTWARE 
5- InstallShield 
H- PackageForTheweb 
H- Software 
(Sy HKEY_USER_SELECTABLE 
(© HKEY_USERS 


4. Enter a meaningful name now to rename the key. If you want to change the name later, right-click on 
the key and select Rename. 


5. Right-click on the new key and select whether the key is to be created on installation, deleted on 
uninstallation, or both. 


Destination Computer Registry View 


My Computer 
H- HKEY_CLASSES_ROOT 
S- HKEY_CURRENT_USER 


g on T 77 New (Insert) > 
Sy SOFTWAl Copy (Ctrl+C) 
S- Insta) paste (Ctrl+V) 
H P 
HE) Software| Delete (Del) 
© HKEY_USER_ Rename (F2) 


HKEY_USERS g 
D z v Create Key At Install 


Delete Key At Uninstall 
Both Create And Delete 


Import REG File... 
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Choose one of the following: 
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Option 


Description 


Create Key at Install 


Creates the new registry key during installation if the key does not exist on 
the target machine. 


Delete Key at Uninstall 


Deletes the registry key during uninstallation, regardless of whether they 
key existed prior to the MSI's installation. This means that the key, and all 
its contents and sub-keys, will be removed regardless of whether other 
software information that is unrelated fo this MSI exists. This can have a 
severe impact on other programs; only select this option if you are sure that 
the only software affected is the base MSI. 


Both Create and Delete 


Both of the above scenarios will occur. 


6. Your new key is created with an empty default string value. To modify the value name and data, see 


Creating a Registry Value. 


To remove the key, right-click on it and select Delete. 
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Creating a Registry Value 


Adding a New Value Name 


To add a new value name: 


1. Select Registry from the checklist. The Registry View opens. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 
i File Edit Yiew Go Project Tools Help 
|o ene nmt tes TAASI! 
& Registry 


4% InstallShield Today Source Computer Registry view Source Computer Registry Data 
©) Help z 
i ees My Computer Name Data 
) Package Validation T 
E Prevalidation @ o heal pepe ROOT ab) (Default) (value not set) 
5- Organization a © ria n T_USER fab) ActiveBorder 212 208 200 
Product Properties ni PP ab) ActiveTitle 0 84 227 


Console 
@) Features 5 = eind ab) AppworkSpace 128 128 128 
4 System Configuration 


= rae Background 078 152 
E3 Accessibility e) 
Files and Folders ay = Aopesrence fab) ButtondlternateFace 181 181 181 
Registry © ab) ButtonDkShad 113 111 100 
Colors IUECONI adow 

Shortcuts 

ButtonFace 236 233 216 
INI Files © Current = 


; Cursors 
NT Services © 


ODBC Resources Destination Computer Registry View 


3- pplication Configuration My Computer Data 


E Server Locations E- HKEY_CLASSES_ROOT 
[R] Setup Properties IES HKEY CURRENT _USER 
É Dialogs =- HKEY_LOCAL_MACHINE 


o gh Add/Remove Programs (©) HKEY_USER_SELECTABLE 
S- Package Preparation (© HKEY_USERS 


Postvalidation 
Package 


5- Additional Tools 
E] Direct Editor 


(value not set) 


El MSI Validation A Transform Validation A Packaging A Output 7 


2. Select the key to which you want to add a value from the Destination Computer Registry view. Existing 
values for the key are displayed in the Destination Computer Registry Data view. 
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3. Right-click in the list of values and select New String Value, New Binary Value, or New DWORD Value, 
depending on the type of data you want to register. 


Destination Computer Registry view 


Destination Computer Registry Data 


pi Computer Name Data 
4 HKEY_CLASSES_ROOT eS i 
S- HKEY_CURRENT_USER New String — eae | 
GD PFTW Key 
H- HKEY_LOCAL_MACHINE 
(© HKEY_USER_SELECTABLE - 
{© HKEY_USERS Modify 


New Binary Value 


New DWOR 


A new empty value name is created with the name "New Value #n" (where n is a successive number). 


Destination Computer Registry Data 


Name Data 
ab) (Default) (value not set) 


(zero length binary value) 


4. Enter a meaningful name now to rename the value. To rename the value later, rightclick on the value 
name and select Rename. 


When creating binary values, Tuner automatically converts whatever input you provide into a binary value. 


Modifying the Value Data 


Each new key has an empty default string value. 


To modify this or any value data: 
1. Right-click on a value name and select Modify. The Edit Data dialog appears. 


Edit Data 


Value name: 
PFTW Value 


Value data: (REG_BINARY) 
400 


2. In the Value data text box, enter a new value or edit the existing value and click OK. 
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Importing REG Files 


Tuner allows you to import any existing REG files that you may have created previously. To import a REG file you 
need to launch the Registry Import Wizard. 


To import a REG file: 


1. Select Registry from the checklist. The Registry View opens. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 


| Eie Edit View Go Project Tools Help 
|o ene nmt ye» | BaX~|\OSL!\0@ 
& Registry 


9% InstallShield Today Source Computer Registry view Source Computer Registry Data 
©) Help 7 
on ET = My Computer Name Data 
1 at pantera i G HKEY_CLASSES_ROOT ab) (Default) (value not set) 
S- Organization ig © Deae fab) ActiveBorder 212 208 200 
+ 
i + eTil 7 
E © conso + Hebe eee 
=) System Configuration - Control Panel ab) flied ae 
aed = HE) Accessibility Sa) Backgroun 078 152 
Files and Folders E- Appearance ab)ButtonalternateFace 181 181 181 


Registry ab) ButtonDkShadow 113 111 100 
Shortcuts © Colors 


INI Files 

NT Services 

ODBC Resources Destination Computer Registry View 
=) Application Configuration 


© Current ab) ButtonFace 236 233 216 
{© Cursors i 


k My Computer | Data 
§ server Locations =- HKE'Y_CLASSES_ROOT 

{2) Setup Properties KE¥_CURRENT_USER 

É Dialogs E-E HKE'Y_LOCAL_MACHINE 


= gh Add/Remove Programs {© HKEY_USER_SELECTABLE 
=) Package Preparation (© HKEY_USERS 


Postvalidation 
Package 


5- Additional Tools 
(BB Direct Editor 


(value not set) 


El MSI Validation A Transform Validation A Packaging A Output 7 
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2. Right-click on a registry hive in the Destination Computer Registry View and select Import REG File. The 
Welcome panel of the Import REG File Wizard appears. 


Import REG File Wizard. 


Welcome to the 
Registry Import Wizard 
[me] eel 
This wizard will allow you to merge the contents of a 


Registry (.reg) file with the Registry data for the selected 
component, 


Import REG File Wizard 


Import Registry File. 
Select the registry File. 


Enter the path and name of the Registry file that you want to import, or click Browse to 
locate the file. 


Registry File: 


Browse... 
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4. In the Registry File text box, either type the location of the registry file or browse to it, and click Next. 
The Import Conflict Options panel appears. 


Import REG File Wizard 


Import Conflict Options 
Select a method For overwriting duplicate keys. 


While importing data From the Registry file, the wizard may encounter registry keys and 
values already present in this registry data. 


Specify how the wizard should handle duplicate keys. 


Ox 


IF conflicts exist, the wizard will overwrite the registry keys and values with any 
duplicate keys From the Registry (.reg) file. 


O Do not overwrite the registry data 


If duplicate keys and values are encountered, the wizard will not overwrite the 
existing registry data. 


5. Select how you would like to handle duplicate registry data during the import. You have two options: 


Option Description 

Overwrite the registry If any conflicts exist, the old registry keys will be overwritten by the new keys. 
data 

Do not overwrite the If duplicate keys are encountered, keep the existing keys. 

registry data 
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6. After you have selected the method, click Import to continue. The Finishing Registry Import panel 
appears. 
Import REG File Wizard 


Finishing Registry Import. 
The wizard will Finish importing your registry data in a moment. 


REG File Import Complete 


Import Complete. 


Click Finish to close the wizard 


7. After the registry file has been scanned, click Finish to insert all entries from the REG file into the 
Destination Computer Registry view. You can then modify the entries. 
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Removing Registry Information 


To remove registry information: 


1. Select Registry from the checklist. The Registry View opens. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 
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|o ene nmt +e» masl Donos 
” Registry 


9% InstallShield Today Source Computer Registry View 
©) Help 
4 Package Validation 
E Prevalidation 
S- Organization 
Product Properties 
LD) Features 
4 System Configuration 


1 My Computer 
& © HKEY_CLASSES_ROOT 
=] (m) HKEY_CURRENT_USER 
S- AppEvents 
© Console 
B- Control Panel 


H-E Appearance 
© Colors 

INI Files = Net 

NT Services 


ODBC Resources Destination Computer Registry View 

5- Application Configuration 7 
[J Server Locations Œ E HKEY_CLASSES_ROOT 
[E] Setup Properties z passes 
` URRENT_USER 

Dialogs (GS) HKE'Y_LOCAL_MACHINE 


_ A Add/Remove Programs (© HKEY _USER_SELECTABLE 
3- Package Preparation (© HKEY USERS 


Postvalidation 
Package 


=) Additional Tools 
Direct Editor 


a Files and Folders -È Accessiblity 


Registry 
Shortcuts 


My Computer 


Source Computer Registry Data 


Name Data 
ab) (Default) (value not set) 
fab) ActiveBorder 212 208 200 
ab) ActiveTitle 084227 
fab) AppWorkSpace 128 128 128 
fab) Background 078 152 
fab) ButtondlternateFace 181 181 181 
fab) ButtonDkShadow 113 111 100 
fab) ButtonFace 236 233 216 
< 


Destination Computer Registry Data 


Name Data 
ab) (Default) (value not set) 


xj i MSI validation A Transform Validation A Packaging A Output F 


2. Navigate to the registry entry that you want to remove in the Destination Computer Registry View. 


3. If you want to remove a value from a specific key, right-click on the value in the Destination Computer 


Registry Data pane and select Delete. 


Destination Computer Registry Data 


Name Data 
ab) (Default) (value not set) 
immu tmmmbhhimary Vale) 


New String Yalue 
New Binary Yalue | 
New DWORD Yalue 


Modify 


Delete (Del) 


Rename F3 | 
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4. |f you want to remove an entire key, rightclick on the key in the Destination Computer Registry View 
pane and select Delete or press the Delete key. 


Destination Computer Registry View 


My Computer 
H- HKEY_CLASSES_ROOT 
S- HKEY_CURRENT_USER 


Samm — 


B © HKEY LOCAL New (Insert) > 
|— niati AS 
© ie end Copy (Ctrl+C) 
(a HKEY_USER | Paste (ctrl+¥) 
| Delete (Del) 
| Rename (F2) 
Create Key At Install 
Delete Key At Uninstall 
Both Create And Delete 


n A Packaging A, Outpt 


Import REG File... 


Shortcuts 


The Shortcuts view offers an integrated, visual method for adding shortcuts and program folders to the installation. 
Existing shortcuts can also be modified or removed. 


DER) 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


joenes DD t+e> Bax OS 


Shortcuts @& 


Adobe Acrobat 6.0 Professional 

Icon SC_Acrobat_DT.exe 
Description 
Arguments 
Target Type 


J Destination Computer 
S-E DesktopFolder 
Acrobat Elements 6.0 
E Adobe Acrobat 6,0 Profession 
Adobe Acrobat 6,0 Standard 
=) ProgramMenuFolder Target 
© Acrobat Distiller 6.0 Run 
E Adobe Acrobat 6.0 Profession | Working Directory 
E Adobe Acrobat 6.0 Standard [Hot Key 
=) PrintMe Internet Printing 
© Download Driver 
E Learn More 
=) StartupFolder 
Acrobat Assistant 


B-E Package Validation 
Prevalidation 
4 Organization 
Product Properties 
D Features 
=) System Configuration 
|] Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources 
=] (m) Application Configuration 
g Server Locations 


File from file system 
[INSTALLDIR JAcrobat\Acrobat.exe 
Normal Window 


This property displays the name of the icon for 


Give Us Feedback 


[E] Setup Properties 

É Dialogs 

ea Add/Remove Programs 
5- Package Preparation 

Postvalidation 

# Package 
=) Additional Tools 

E] Direct Editor 
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Change Icon button. From the resulting dialog, you can 
browse to an EXE file or DLL, which will then display all 
contained icons. Select the appropriate icon and click OK, The 
name of the icon will appear in the Icon value cell, and a 
picture of the icon will appear next to the Change Icon button. 


Z 


Change Icon... | Clear Icon | 
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Shortcuts can be placed in: 


m folders already defined by the installation, 
E standard folders that are predefined by the Windows Installer such as the Fonts folder, or 
m new folders which you can create. 


Each shortcut has several properties that specify the target program, hot key combination, icon, and other 
information necessary to launch the application. When you create a new shortcut, it will always be installed. 


Shortcuts created in the transform are denoted by ŽA and shortcuts from the base Windows Installer package are 


denoted by Æ. 


Creating Shortcuts 


To create a shortcut: 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


|| Ble Edit Yiew Go Project Tools Help 


joensen tse» mar Dono] 


Shortcuts & 


E {© Package Validation W Destination Computer Adobe Acrobat 6.0 Professional 
| Prevalidation S-E DesktopFolder Icon SC_Acrobat_DT.exe 
| 2- Organization E Acrobat Elements 6.0 Description 
Product Properties E Adobe Acrobat 6.0 Profession | Arguments 
© Features E Adobe Acrobat 6.0 Standard | Target Type File From file system 
| 5- System Configuration S- ProgramMenuFolder Target CINSTALLDIR JAcrobat\Acrobat.exe 
Files and Folders E Acrobat Distiller 6.0 Run Normal Window 
Registry E Adobe Acrobat 6.0 Profession | Working Directory 
Shortcuts E Adobe Acrobat 6,0 Standard | Hot Key 
INI Files S- PrintMe Internet Printing 
NT Services Download Driver 
ODBC Resources Learn More 
S-E Application Configuration S-E StartupFolder A 
§ Server Locations E Acrobat Assistant This property displays the name of the icon for 
[E] Setup Properties this shortcut. You can change it by clicking the 
a Dialogs Change Icon button. From the resulting dialog, you can 
Ea Add/Remove Programs browse to an EXE file or DLL, which will then display all 
=) Package Preparation contained icons. Select the appropriate icon and click OK, The 
8 Postvalidation name of the icon will appear in the Icon value cell, and a 
Package picture of the icon will appear next to the Change Icon button. 
=) Additional Tools 
(PA Direct Editor 


A] 
Change Icon... | Clear Icon | 


2. In the Shortcuts folder tree, navigate to the folder in which you want to put the shortcut. 
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3. Right-click on the folder and select New Shortcut. 


Destination Computer 
a © ALLUSERSPROFILE 
E PackageForTheWeb 4 


Show Folder 


New Shortcut (Ctrl+-Shift+5) 


New Folder {Ins} 


A new shortcut named NewShortcut appears, along with a Properties Grid: 


Destination Computer 
B- ALLUSERSPROFILE 
E PackageForThewWeb 4 |Description 
5-6 ProgramMenuFolder Arguments 
F-2.|lewShortcut Target Type Dest 
Target TAR 
Run Norr 
Working Directory 
Hot Key 


Icon 


4. Provide a name for the shortcut. 


5. Enter properties for the shortcut in the Properties Grid. 
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Changing a Shoritcut's Icon 


To change the icon used for a shortcut: 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


“File Edit View Go Project Tools Help 


joones |DD|t+e>|max~|OSL! ee) 


| (=) (Gy Package Validation W Destination Computer Adobe Acrobat 6.0 Professional 
Prevalidation B-E DesktopFolder Icon 5C_Acrobat_DT.exe 
S-E Organization © Acrobat Elements 6.0 Description 
Product Properties E Adobe Acrobat 6.0 Profession | Arguments 
E Features E Adobe Acrobat 6.0 Standard | Target Type File From file system 
| (=) System Configuration =) ProgramMenuFolder Target [INSTALLDIR JAcrobat\Acrobat.exe 
`) Files and Folders E Acrobat Distiller 6.0 Run Normal Window 
Registry E Adobe Acrobat 6.0 Profession | Working Directory 
Shortcuts E Adobe Acrobat 6,0 Standard | Hot Key 
INI Files =) PrintMe Internet Printing 
NT Services Download Driver 
ODBC Resources Learn More 
a- Application Configuration B-E StartupFolder e] 
9 Server Locations © Acrobat Assistant This property displays the name of the icon for 
[E] Setup Properties this shortcut. You can change it by clicking the 
ca Dialogs Change Icon button. From the resulting dialog, you can 
A Add/Remove Programs browse to an EXE file or DLL, which will then display all 
S-E Package Preparation contained icons. Select the appropriate icon and click OK, The 
# Postyalidation name of the icon will appear in the Icon value cell, and a 


Package picture of the icon will appear next to the Change Icon button, 
EI Additional Tools 
(PA Direct Editor 


Z) Change Icon... | Clear Icon | 


2. In the Shortcuts folder tree, navigate to the folder containing the shortcut you want to edit. 
3. Select the Icon property from the Properties Grid. 


4. Click the Change Icon button in the pane below the grid. The Change Icon Dialog opens. 


Change Icon 


File name: 
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5. Select one of the displayed icons or browse to the file that contains the icon you want to use for the 


shortcut. 


6. After you have selected the appropriate icon, click OK. The new icon is now displayed to the left of the 


Change Icon button. 


Clear Icon | 


Change a Shoricut's Location 


To change a shortcut's location: 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


| (=) (Gy Package Validation W Destination Computer 
Prevalidation B-E DesktopFolder 
S- Organization © Acrobat Elements 6.0 
Product Properties E Adobe Acrobat 6.0 Profession 
€ Features E Adobe Acrobat 6.0 Standard 
S- System Configuration =) ProgramMenuFolder 
`) Files and Folders E Acrobat Distiller 6.0 
Registry ©} Adobe Acrobat 6.0 Profession 
Shortcuts E Adobe Acrobat 6.0 Standard 
INI Files B- PrintMe Internet Printing 
NT Services Download Driver 
ODBC Resources Learn More 
S- Application Configuration B- StartupFolder 
g Server Locations E Acrobat Assistant 
[E] Setup Properties 
E Dialogs 
A Add/Remove Programs 
S-E Package Preparation 


Postyalidation 
Package 


1} Additional Tools 
(PA Direct Editor 


Shortcuts 


Adobe Acrobat 6.0 Professional 

Icon SC_Acrobat_DT.exe 

Description 

Arguments 

Target Type File From File system 

Target [INSTALLDIR JAcrobat\Acrobat.exe 
Run Normal Window 

Working Directory 

Hot Key 


This property displays the name of the icon for 

this shortcut. You can change it by clicking the 

Change Icon button. From the resulting dialog, you can 
browse to an EXE file or DLL, which will then display all 
contained icons. Select the appropriate icon and click OK, The 
name of the icon will appear in the Icon value cell, and a 
picture of the icon will appear next to the Change Icon button. 


A] 
ZA Change Icon... | Clear Icon | 


2. In the Shortcuts folder tree, navigate to the folder containing the shortcut you want to move. 


W Destination Computer 
E] B ALLUSERSPROFILE 

E PackageForTheweb 4 
B-E ProgramMenuFolder 

A 
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3. Select the shortcut and drag it to another folder in the Shortcuts tree. 


W Destination Computer 
=) =) ALLUSERSPROFILE 


fs 
E PackageForThewWeb 4 
{© ProgramMenuFolder 


Changing a Shortcut's Target 


To change a shortcut's target: 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


9 Customizing Packages 


Dene DD ++e>\Hax~ DIL! 


| 5- Package Validation W Destination Computer Adobe Acrobat 6.0 Professional 
Prevalidation S-E DesktopFolder Icon SC_Acrobat_DT.exe 
| 2- Organization E Acrobat Elements 6.0 Description 
Product Properties Adobe Acrobat 6.0 Profession | Arguments 
E) Features E Adobe Acrobat 6.0 Standard | Target Type File From file system 


m 


Shortcuts fà 


| 5- System Configuration S-E ProgramMenuFolder Target CINSTALLDIR JAcrobat\Acrobat.exe 


Files and Folders E Acrobat Distiller 6.0 Run Normal Window 
Registry E Adobe Acrobat 6.0 Profession | Working Directory 
Shortcuts E Adobe Acrobat 6,0 Standard | Hot Key 
INI Files S- PrintMe Internet Printing 
NT Services Download Driver 
ODBC Resources E Learn More 
S-E Application Configuration S- StartupFolder 


g Server Locations E Acrobat Assistant This property displays the name of the icon for 
[E] Setup Properties this shortcut. You can change it by clicking the 
E Dialogs Change Icon button. From the resulting dialog, you can 
Ea Add/Remove Programs browse to an EXE file or DLL, which will then display all 
5- Package Preparation contained icons. Select the appropriate icon and click OK, The 
8 Postvalidation name of the icon will appear in the Icon value cell, and a 
Package picture of the icon will appear next to the Change Icon button. 


=) Additional Tools 
E Direct Editor 


Zi Change Icon... | Clear Icon | 


2. In the Shortcuts folder tree, navigate to the folder containing the appropriate shortcut. 
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3. Select the Target property from the Properties Grid. 


Destination Computer Package 
B- ALLUSERSPROFILE Icon CST_ICONO1 ico 
E PackageForThewWeb 4 |Description 

B- ProgramMenuFolder Arguments 

FZ Package Target Type File from file system 
Target 4 
Run Normal Window 
Working Directory 

Hot Key 


4. Select the appropriate Target from the list. The Target Type that is selected affects what you should enter 
in the Target property field: 


a File from MSI Package & File from File System: Provide the full path to the application or 
batch file. 


= Destination Folder: Select a folder name from the drop-down list. The list includes available 
folders on the target system, from the MSI package, and from the transform. 

= Advertised Shortcut: Enter the feature name. You can determine the name of the feature by going 
to the Direct Editor and selecting the Feature table. The list of features that you can target is listed in 
the Features column of the table. 
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Creating a Hot Key 


A Hot Key is a combination of keys used to launch a shortcut instead of using the mouse. 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 


| Bile Edit View Go Project Tools Help 


jcene#|DD|t+e> Bat OSL! e@ 


| (=) (Gy Package Validation W Destination Computer Adobe Acrobat 6.0 Professional 
Prevalidation B-E DesktopFolder Icon 5C_Acrobat_DT.exe 
S-E Organization © Acrobat Elements 6.0 Description 
Product Properties E Adobe Acrobat 6.0 Profession | Arguments 
E Features E Adobe Acrobat 6.0 Standard | Target Type File From file system 
| (=) System Configuration =) ProgramMenuFolder Target [INSTALLDIR JAcrobat\Acrobat.exe 
`) Files and Folders E Acrobat Distiller 6.0 Run Normal Window 
Registry E Adobe Acrobat 6.0 Profession | Working Directory 
Shortcuts E Adobe Acrobat 6,0 Standard | Hot Key 
INI Files =) PrintMe Internet Printing 
NT Services Download Driver 
ODBC Resources Learn More 
a- Application Configuration B-E StartupFolder 
9 Server Locations © Acrobat Assistant This property displays the name of the icon for 
[E] Setup Properties this shortcut. You can change it by clicking the 
ca Dialogs Change Icon button. From the resulting dialog, you can 
A Add/Remove Programs browse to an EXE file or DLL, which will then display all 
S-E Package Preparation contained icons. Select the appropriate icon and click OK, The 
# Postyalidation name of the icon will appear in the Icon value cell, and a 


Package picture of the icon will appear next to the Change Icon button, 
1} Additional Tools 
(PA Direct Editor 


Z) Change Icon... | Clear Icon | 


2. Select the shortcut to which you want to add the Hot Key. 


3. Click on the Hot Key field in the properties grid. The Hot Key dialog opens. 
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4. Press the keys on the keyboard that you want to use for the shortcut. The shortcut appears in the dialog. 


Press new shortcut key: 


Cril + Alt + F4 


5. Ifthe shortcut is correct, click OK. The dialog closes and the shortcut's converted ASCII value appears 
as the value for the Hot Key. 


Package 
Icon CST_ICONO1.ico 
Description 

Arguments 

Target Type File From file system 
Target DesktopFolder 

Run Normal Window 
Working Directory 
Hot Key 


These four fields in the Shortcuts Property Box are required for creating a Hot Key: Icon, Target, Run, and Hot Key. 
When you are creating the Hot Key Combination, DO NOT use a keyboard combination already adopted by Microsoft 
(such as Ctrl+V, which is used for Paste). Otherwise, the shortcut will not work. 
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Removing Shortcuts 


To remove a shortcut: 


1. Select Shortcuts from the checklist. The Shortcuts View opens. 


9 Customizing Packages 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 
| Bile Edit View Go Project Tools Help 


joensen t+e>| 


QA\OSL!/O@ 


Adobe Acrobat 6.0 Professional 


| (=) (Gy Package Validation 
Prevalidation 
B-E Organization 
Product Properties 
D Features 
| (=) System Configuration 
`) Files and Folders 
Registry 
Shortcuts 
INI Files 


Destination Computer 
5- DesktopFolder 
E Acrobat Elements 6.0 
E Adobe Acrobat 6.0 Profession 
E Adobe Acrobat 6.0 Standard | Target Type 
=) ProgramMenuFolder Target 
E Acrobat Distiller 6.0 Run 
E Adobe Acrobat 6.0 Profession | Working Directory 
E Adobe Acrobat 6,0 Standard | Hot Key 
E-E) PrintMe Internet Printing 


Icon 
Description 
Arguments 


SC_Acrobat_DT.exe 


File From file system 
[INSTALLDIR JAcrobat\Acrobat.exe 
Normal Window 


Download Driver 
Learn More 
B- StartupFolder 
E Acrobat Assistant 


NT Services 
ODBC Resources 
a- Application Configuration 
g Server Locations 
[E] Setup Properties 
E Dialogs 
A Add/Remove Programs 
S-E Package Preparation 
Postvalidation 
# Package 
EI Additional Tools 
(PA Direct Editor 


This property displays the name of the icon for 
this shortcut. You can change it by clicking the 

Change Icon button. From the resulting dialog, you can 

browse to an EXE file or DLL, which will then display all 
contained icons. Select the appropriate icon and click OK, The 
name of the icon will appear in the Icon value cell, and a 

picture of the icon will appear next to the Change Icon button, 


Z 


Change Icon... | Clear Icon | 


2. Use the Shortcuts Tree to navigate to the shortcut you want to delete. 


3. Right-click on the shortcut and select Delete to remove it. 


Destination Computer 


S- ALLUSERSPROFILE Icon 
E PackageForTheweb 4 | Descriptio 
S- ProgramMenuFalder Argument 
Show Folder | 
Copy (Ctrl+C) 
Rename (F2) 


Delete (Del) 
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Determining the Path of Changed Shortcuts 


To determine the actual path of a changed shortcut: 


1. Go to the Direct Editor and select the Directory table. 


Paint Shop Pro 7 Anniversary Edition1.mst (Paint Shop Pro 7 Anniversary Edition.msi) - InstallShield Tuner 


le Edit View Go Project Tools Help 


tte» |X |SBGL! (Os 


æl Direct Editor 


Pay InstallShield Today AdminUISequence a, Directory -572 Directory_Parent-S72 |DefaultDir - 1255 
@ Help & AdvtExecuteSequence INSTALLDIR, DIR26 PAINTS~1|Paint Shop Pro 7 
(=) Package Validation AdvtUISequence TARGETDIR SourceDir 
BA Prevalidation AppId AppDataFolder TARGETDIR JAPPLIC~1|Application Data 
) Organization E AppSearch CommonFilesFolder TARGETDIR «Common 
Product Properties E BBControl -| DesktopFolder TARGETDIR «Desktop 
E Features E Billboard FontsFolder TARGETDIR „Fonts 
B- System Configuration E Binary FavoritesFolder TARGETDIR JFAVORI~1 |Favorites 
Q Files and Folders BindImage _. NetHoodFolder TARGETDIR, .:NetHood 
oe Registry CCPSearch PersonalFolder TARGETDIR «Personal 
Shortcuts E CheckBox PrintHoodFolder TARGETDIR JPRINTH~1|PrintHood 
INI Files Class ProgramFilesFolder TARGETDIR J PROGRA~1 |program files 
NT Services ComboBox ProgramMenuFolder TARGETDIR „Programs 
ODBC Resources CompLocator RecentFolder TARGETDIR, „Recent 
S- Application Configuration ‘omplus SendToFolder TARGETDIR SendTo 
a Server Locations Component StartMenuFolder TARGETDIR JSTARTM~1|Start Menu 
m Setup Properties {rea Condition StartupFolder TARGETDIR, «StartUp 
im Dialogs Control System16Folder TARGETDIR System 
ug) Add/Remove Programs E controlcondition SystemFolder TARGETDIR uSystem32 
2- Package Preparation ControlEvent TempFolder TARGETDIR „Temp 
Postvalidation reateFolder TemplateFolder TARGETDIR ShellNew 
Package Customaction WindowsFolder TARGETDIR «Windows 
S- Additional Tools E Dialog AdminToolsFolder TARGETDIR, JAdmint~1|AdminTools 
E Direct Editor CommonappDataFolder TARGETDIR .Commone1|CommonAppData 
DrLocator 4) Sig) 


El MSI Validation A Transform Validation A Packaging A Output / 
y 


Directory - 122 rows NUM 


2. Find the shortcut Target directory, such as INSTALLDIR. 


3. In that Directory row, find the value in the Directory_Parent column. In this example, the value is DIR26. 


4. Look for a row in the Directory column that does not have a Directory_Parent entry. The directory in the 
row that has no value in the Directory_Parent column is the root directory. In this example, the root 
directory is TARGETDIR. 
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Initialization (INI) files serve as a repository in which you can store and retrieve information between uses of your 
application. Typically INI Files contain key name-value pairs representing run-time options for applications. Some „ini 
files, such as Boot.ini and Wininit.ini, are used by the operating system. 


INI files are divided into sections, each section containing keywords. Sections are divided by the square brackets 
surrounding them—[SectionNamel], for example. INI file keywords are the lowest level of organization in an „ini file. 
These keywords store data that must persist between uses of an application. 


The INI Files View provides a graphical way for users to add, modify, or delete the contents of the IniFile Table. It 
displays the contents of the IniFile table from the source Windows Installer package and the transform. 


InstallShield AdminStudio.mst (InstallShield AdminStudio.msi) - InstallShield Tuner DAR) 
| File Edit View Go Project Tools Help 


|o enajon t +e» mns eo: os 


Pay InstallShield Today Destination Computer QuickStart Guide 
@) Help (=) () ProgramFilesFolder 
S- Package Validation S- InstallShield a, | AppHelpFile [INSTALLDIR ]Program\040 Add Line 
Prevalidation S- Adminstudio a) AppArguments [INSTALLDIR JProgram\040 Add Line 
S- Organization Be 5.0 A Demo32.exe Add Line 
Product Properties a “> AdminStudio. ini a i [INSTALLDIRJProgram\040 Add Line 
©) Features ab] QuickStart Guide 
S- System Configuration a- Common 
Files and Folders = > Developer. ini AppLocation 
Registry ab] developer 


Shortcuts (Cy Repackager Keys have the following properties, which must be set in order 


INI Files E > isqm.ini for your INI file change to occur: 
NT Services 


ODBC Resources 

o- Application Configuration Property Description 
g Server Locations 

[E] Setup Properties Key 


The name of the key. This should be entered in the exact 


Lag Dialogs way it should appear in the target INI file. 
£ ch Add/Remove Programs 


S- Package Preparation , ; 
# Postvalidation The key's value, Windows Installer properties can be used 


Package in your keyword's value. To do this, surround the property 
S- Additional Tools with square brackets—[INSTALLDIR], for example. 


E] Direct Editor 


Action The action they key performs. Select this fram the list in 


the property sheet. The available options allow you to add 
a line, add a tag, or create a line, 


Ej For a comprehensive list of Windows Installer properties, refer 
to the Property Reference topic in the MSI Help. 


aff MSI Validation A Transform Validation A Packaging A Output 7 
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Adding INI Files 


To add an INI file to your transform file: 


1. Select INI Files from the checklist. The INI Files View opens. 


InstallShield AdminStudio.mst (InstallShield AdminStudio.msi) - InstallShield Tuner 
|| Bile Edit View Go Project Tools Help 
|o e nemt +e» mazeo: 
© INI Files 


Pay InstallShield Today WW Destination Computer 
@) Help S- ProgramFilesFolder 
=) Package Validation S- InstallShield A% il [INSTALLDIR JProgram\040 Add Line 
E Prevalidation 4) Adminstudio A [INSTALLDIR ]Program\040 Add Line 
4 Organization a 5.0 a. AppDefault Demo32.exe Add Line 
Product Properties a $ AdminStudio. ini lz, | AppLocation [INSTALLDIR JProgram\040 Add Line 
CD Features ab] QuickStart Guide 
=] o System Configuration B B Common 
Files and Folders S] > Developer. ini AppLocation 
Registry ab] developer 
Shortcuts S-E Repackager Keys have the following properties, which must be set in order 


INI Files E 4 isqm.ini for your INI file change to occur: 
NT Services 


ODBC Resources a - — 
S- Application Configuration Property Description 
Server Locations 


[E] Setup Properties Key The name of the key. This should be entered in the exact 


a rie > way it should appear in the target INI file. 
. emove Programs 


=) ( Package Preparation i ; 
R Postvalidation The key's value. Windows Installer properties can be used 


Package in your keyword's value. To do this, surround the property 
S- Additional Tools with square brackets—[INSTALLDIR], for example. 


E] Direct Editor 


The action they key performs. Select this from the list in 
the property sheet. The available options allow you to add 
a line, add a tag, or create a line. 


j For a comprehensive list of Windows Installer properties, refer 
to the Property Reference topic in the MSI Help. 


= MSI Validation Á Transform Validation A, Packaging A, Output 
x 
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Right-click on the appropriate destination folder in the INI File tree and select New IniFile. 


Destination Computer 
2- ProgramFilesFolder 
B- InstallShield 


Each folde 
B- Adminstudio represents 
SC 5.0 file is inste 
S-E AdminStudio. ini of two typ: 
ab] QuickStart Guide Ginee creat 
Ck 
= | Show Folder 
Gy Repag oo 


Add (Insert) 


Delete (Del) 
| Rename (F2) 


A new INI file, named IniFile#.ini, is created under the selected destination folder, complete with a 
default section (NewSection#) (where # represents a sequential number). 


Destination Computer 
B-E ProgramFilesFolder 
B- InstallShield 
=) Adminstudio 
a 5.0 
-i$ AdminStudia. ini 
B- Common 


} Developer. ini 
IniFile1 ini 


ab) NewSection1 


NewSection1 
Action 
Add Line 


NewYalue 


D-E 


To rename the new INI file, select IniFile#.ini and select Rename from the context menu. 
To rename the new INI section, select NewSection#.ini and select Rename from the context menu. 


With the new INI section selected, enter a Key name, Value, and Action for the default INI key value. 
See Modifying INI File Keys, Values, and Actions. 


Add additional Sections and Keys, as described in Adding Sections to INI Files and Adding New Keys 
to INI File Sections. 
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Importing Existing INI Files 


To import an existing INI file: 


1. Select INI Files from the checklist. The INI Files View opens. 


InstallShield AdminStudio.mst (InstallShield AdminStudio.msi) - InstallShield Tuner 


|| Bile Edit View Go Project Tools Help 


9 Customizing Packages 


|o e nemt +e» mazeo: 
& INI Files 


4ft InstallShield Today 
@) Help 
S- Package Validation 
E Prevalidation 


Destination Computer 
S- ProgramFilesFolder 
S- InstallShield 
5- Adminstudio 


4 Organization 
Product Properties 
CD Features 

B- System Configuration 


a 5.0 
=} Adminstudio. ini 
ab] QuickStart Guide 
24 Common 


a. AppDefault 
la, AppLocation 


= > Developer. ini AppLocation 
ab] developer 
2- Repackager 


iE “> isqm. ini 


Files and Folders 
Registry 
Shortcuts 


INI Files 
NT Services 


Keys have the following properties, which must be set in order 
for your INI file change to occur: 


[INSTALLDIR JProgram\040 Add Line 
[INSTALLDIR ]Program\040 Add Line 
Demo32.exe Add Line 
[INSTALLDIR JProgram\040 Add Line 


ive Us Feedback 


ODBC Resources 


=) Application Configuration Property 


Description 


Server Locations 
E] Setup Properties Key 
É Dialogs 


The name of the key. This should be entered in the exact 
way it should appear in the target INI file. 


ra) Add/Remove Programs 
=) ( Package Preparation 


Postvalidation 
Package 


S- Additional Tools 


The key's value. Windows Installer properties can be used 
in your keyword's value. To do this, surround the property 
with square brackets—[INSTALLDIR], for example. 


E] Direct Editor 


The action they key performs. Select this from the list in 
the property sheet. The available options allow you to add 
a line, add a tag, or create a line. 


j For a comprehensive list of Windows Installer properties, refer 
to the Property Reference topic in the MSI Help. 


= MSI Validation Á Transform Validation A, Packaging A, Output 
x 
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2. Right-click on the appropriate destination folder in the INI File tree and select Import INI File from the 
context menu. 


3 Destination Computer Repackager 
o- ProgramFilesFolder 
E=) InstallShield — Each folder displa 
a © AdminStudio the folder into wh 
= (m) 5.0 target system. Fo 
8 AdminStudio.ini Windows, Standar 
SQ Common 7 such as Installs! 
E- $ Developer. ini names and locatic 
ao Show Folder » 
fl sgm 
New IniFile 
Copy (Ctrl+C) 
Paste (Ctrl+¥) 
Add (Insert) 
Delete (Del) 
Rename (F2) 
Import INI File... 


The Welcome Panel of the Import INI File Wizard opens. 


Import INI File Wizard. 


Welcome to the 
INI File Import Wizard 


This wizard will allow you to merge the contents of an INI file 
Gini) File with the data in the IniFile table For the selected 
component, 
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3. Click Next. The Import INI File Panel opens. 


Import INI File Wizard 


Import IniFile. 
Select the Inifile. 


Enter the path and name of the INI file that you want to import, or click Browse to locate 
the file. 


INI File: 


Browse... 


4. Enter or browse to the INI file you want to import. Click Next. The Import Conflict Options Panel opens. 


Import INI File Wizard 


Import Conflict Options 
Select a method for overwriting duplicate keys. ile =] 


While importing data From the INI file, the wizard may encounter INI file keys and values 
already present in the IniFile table. 


Specify how the wizard should handle duplicate keys. 


Oğ 


IF conflicts exist, the wizard will overwrite the INI file keys and values with any 
duplicate keys from the INI file ¢. ini). 


© Do not overwrite the data in the IniFile table 


Tf duplicate keys and values are encountered, the wizard will not overwrite the 
existing data in the IniFile table, 


5. Select how you want to handle duplicate keys and values. Click Import. 


6. Once the INI file has been imported, click Finish. 


The imported INI file appears under the selected destination folder. You can then make further adjustments to it as 
needed. 
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Adding Sections to INI Files 


To add a section to an INI file: 
1. Select the INI Files View from the checklist. 


2. Right-click on the appropriate INI File in the INI File tree and select New Section. 


Destination Computer 
B- CommonFilesFolder 
=) Symantec Shared 
24 VirusDefs 


E > ET New Section (Insert) | 
ab] DefDate 


1 
| 
-" USAGE.DAT Copy (Ctrl+C) 


4) WindowsFolder Past res 
> ODBC. INI 
tH - ODBCINST.INI Delete (Del) 


Rename (F2) 


A new INI section, named NewSection1, is created under the selected INI file, complete with a default 
Key name, Value, and Action. 


Destination Computer 
I CommonFilesFolder 
B-E Symantec Shared la, NewKey Newvalue 
4 VirusDefs 

S$ DEFINFO.DAT 

ab] DefDates 
Fp NewSection1 

i} USAGE.DAT 

H- WindowsFolder 


NewSection1 


Add Line 


3. To rename the new section, select NewSection1] and select Rename from the context menu. 


4. With the new INI section selected, enter a Key name, Value, and Action for the default INI key value. 
See Modifying INI File Keys, Values, and Actions. 


5. Add additional Keys to this new INI file section as necessary. See Adding New Keys to INI File 
Sections. 


Adding New Keys to INI File Sections 


To add a new INI file key: 
1. Select the INI Files View from the checklist. 


2. Expand the listing of the INI file that you would like to edit so that all of its sections are displayed. 
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3. Select the INI file section that you would like to edit. That section's defined keys are listed on the right. 


INI Files & 


yg Destination Computer CBA_EH_DB 
B- CommonFilesFolder 
H- Symantec Shared 
B- WindowsFolder 
i+ startup. ini 
4 ODBC. INI 
ab] 
ab] CB4_TL_DB 
ab] ODBC 32 bit Data Sources 
i) ODBCINST. INI 


Action 


| Driver32 [WindowsFolder]\System3; Create Line 


4. Right-click in the key listing and select Add from the menu. 


[WindowsFolder]\System3: Create Line 


Add (Insert) 


|__| Driver32 


Delete (Del) 


A new key is added to the key listing with a default Key name, Value and Action. 


INI Files 


CBA_EH_DB 


Action 
|_| Driver32 (WindowsFolder]\System3; Create Line 
la. | NewKey1 Newalue Add Line 


5. Edit the Key name, Value, and Action for this new Key. See Modifying INI File Keys, Values, and 
Actions. 
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Modifying INI File Keys, Values, and Actions 


INI files contain key name-value pairs representing run-time options for applications. To define and modify the key 
names, values, and /or actions, perform the following steps. 


To modify keys, values, and/or actions in INI files: 


2. 


3. 


Select the INI Files View from the checklist. 


In the INI File tree, select the INI file that you want to edit, and expand the listing so that you can select 
the appropriate section. 


That section's keys, values, and actions are listed: 


Destination Computer developer 
B- ProgramFilesFolder 


Action 


S- InstallShield Y Add Line 
B- Adminstudio InstallShield Developer - AdminStudio Edition Add Line 
a- 5.0 Ver Includes 8.01 Add Line 

E] $ AdminStudio. ini ConflictServices [INSTALLDIR]Common\ISUIConflictServices.c| Add Line 

=) Common FileOpen [INSTALLDIR]JCommon\45FileOpen.dll Add Line 

=) “> Developer. ini ISToday [INSTALLDIR ]Developer\Program\O409\ISADI Add Line 

ab| developer HelpFile [CommonFilesFolderJInstallShield\AdminStudic Add Line 

H- Repackager Extensions Repackager Output File (*.inc) | *.inc, ZENwe Add Line 
EvalCheck [INSTALLDIR]Common\ISCommonHelper.dil Add Line 

InstallLocation = [INSTALLDIR JDeveloper Add Line 

NavFile [INSTALLDIR ]Developer\Program\O409\isproz Add Line 


Modify the Key name, Value, and Action for each key, as necessary. 


Property Description 

Key The name of the key. This should be entered in the exact way you want it to appear in the 
target INI file. 

Value The key's value. Windows Installer properties can be used in your keyword's value. To do 


this, surround the property with square brackets—[INSTALLDIR], for example. For a 
comprehensive list of Windows Installer properties, refer to the Property Reference topic in 
the MSI Help. 


Action The action the key performs. Select this from the list in the property sheet. The available 
options are: 


= Add Tag: Creates a new entry or appends a new comma-separated value to an existing 
entry. 

= Create Line: Creates a .ini entry only if the entry does not already exist. 

= Add Line: Creates or updates a .ini entry. 
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Removing INI Files 


To remove an INI file: 
1. Select the INI File view from the checklist. 


2. From the INI File tree, right-click on the INI file you want to delete and select Remove. 


Removing Sections from INI Files 


To remove a section from INI file: 
1. Select the INI File view from the checklist. 


2. From the INI File tree, rightclick on the section you want to delete and select Remove. 


Removing INI File Section Keys 


To remove an INI file section key: 
1. Select the INI Files view from the checklist. 
2. Select the INI File section that contains the key you want to delete from the INI Files tree. 


3. Right-click the key you want to remove and select Delete. 


InstallShield Software Corporation © 2004 424 


AdminStudio 5.5 User Guide 


ODBC Resources 


9 Customizing Pack 


ages 


Open Database Connectivity (ODBC) Resources are ones that involve interaction with databases. Tuner allows you to 


view existing ODBC Data Sources, ODBC Drivers, and ODBC Translators. 


Adding New Data Sources 


To add a new ODEC Data Source: 


1. Select ODBC Resources from the checklist. The ODBC Resources View opens. 


Install_ODBC_Resources.mst (Install ODBC_Resources.msi) - InstallShield Tuner 


| File Edit View Go Project Tools Help 


joenw|ClG|t ++>/@axzleeL! les 


5- Package Validation t ODBC Resources ODBC Resources Yiew 
E Prevalidation B-E ODBC Data Sources 


ODBC Resources Z 


SC Organization # dbase Files Open Database Connectivity (ODBC) Resources are | Give Us Feedback 


Product Properties Fi Excel Files 
Z Features Fi Flight32 
B- System Configuration A FoxPro Files 


ones that involve interaction with databases. Tuner 
allows you to view existing ODBC Data Sources, ODBC Drivers, 
and ODBC Translators. The left pane of the ODBC Resources view 


a Files and Folders # mais contains a tree with the three root nodes: ODBC Data Sources, 


Registry pa] MS Access 97 Database 
F Shortcuts Fi my New DSN 1 
$ INI Files Fi my New DSN 2 
E Text Files 
a H- ODBC Drivers 
B- Application Configuration w- ODBC Translators 
4 Server Locations 


ODBC Drivers, and ODBC Translators. When any of these are 
expanded, individual Data Sources, Drivers, and Translators 
contained in the Windows Installer package are displayed. When 
selected, each of these individual nodes displays information in a 
property grid displayed in the upper right pane. 


[E] Setup Properties Ej Only ODBC Data Source attributes are editable; 


É} Dialogs 


ea) Add/Remove Programs in read-only form, 
5- Package Preparation 


Postvalidation 
Package 


5- Additional Tools 
E Direct Editor 
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2. Right-click either ODBC Data Sources group or one of its children groups from the ODBC Resources 
tree and select New Data Source from the context menu. The ODBC DataSource Dialog opens. 


ODBC DataSource 


ODBC DataSources: 


MS Access Database 

SEA Local Db c:/sea/client 
SEA MMerge c:/sea/client 

SEA MSQL c:/sea/client 

SEA MSQL_OLAP c:/sea/client 
SEA Text c:/sea/client 


Excel Files 


3. Select the required data source and click OK. 


If you are adding an ODBC Data Source that does not exist on your computer, type the name of the Data Source into 


the ODBC Data Source dialog. Keep in mind that adding a data source to a Windows Installer package that does not 
contain the corresponding driver may render the package useless. 
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Adding New ODBC Data Source Attributes 


To add a new ODEC data source attribute: 


1. Select ODBC Resources from the checklist. The ODBC Resources View opens. 


Install_ODBC_Resources.mst (Install ODBC_Resources.msi) - InstallShield Tuner 


i File Edit View Go Project Tools Help 


j>Gk@#|DD|t+e>|Bax~ OSL!\0@ 


B- Package Validation 
Prevalidation 

B- Organization 
Product Properties 
B Features 

B- System Configuration 


Files and Folders 
Registry 


Shortcuts 
INI Files 
NT Services 
í Lesi 
5- Application Configuration 

g Server Locations 

[E] Setup Properties 

É} Dialogs 

A Add/Remove Programs 
=] (=) Package Preparation 


Postvalidation 
Package 


5- Additional Tools 
E] Direct Editor 


2. Select the ODBC Data Source to which you want to add a new attribute from the ODBC Resources tree. 


= ODBC Resources 

5- ODBC Data Sources 
Fi dBASE Files 
Fi Excel Files 
Fi Flight32 
Fi FoxPro Files 
Fi mais 
Fl Ms Access 97 Database 
Fi my New DSN 1 
Fi My New DSN 2 
FA Text Files 

H- ODBC Drivers 

H-E ODBC Translators 


ODBC Resources = 


ODBC Resources ¥iew 


Open Database Connectivity (ODBC) Resources are | Give Us Feedback 


ones that involve interaction with databases, Tuner 

allows you to view existing ODBC Data Sources, ODBC Drivers, 
and ODBC Translators. The left pane of the ODBC Resources view 
contains a tree with the three root nodes: ODBC Data Sources, 
ODBC Drivers, and ODBC Translators, When any of these are 
expanded, individual Data Sources, Drivers, and Translators 
contained in the Windows Installer package are displayed. When 
selected, each of these individual nodes displays information in a 
property grid displayed in the upper right pane. 


EA Only ODBC Data Source attributes are editable; 
ODBC Drivers and ODBC Translators are provided 
in read-only form. 


The property grid for the selected ODBC Data source opens. 


m ODBC Resources 
B- ODBC Data Sources 
Fi dBASE Files 
# Excel Files 
Fi Flight32 
SA FoxPro Files 
F mais 
Fi Ms Access 97 Database 
SE my New DSN 1 
SA My New DSN 2 
SA Text Files 
5- ODBC Drivers 
Microsoft Access Driver (*.m 
Microsoft dBase Driver (*.db 


FoxProFiles 
Attribute 
|__| Registration 
|_| Driver Description 
|__| Feature 

|_| SafeTransactions 
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3. Right-click in the property grid and select Add. A new attribute is listed, with the default values of 


ATTRIBUTE and NULL_VALUE. 


FoxProFiles 
Attribute ¥Yalue 
CJ Registration User Data Source 
CJ Driver Description Microsoft FoxPro Driver (*,.dbF} 
C Feature NewFeaturel 
(J SafeTransactions 
[Jum 
re ATTRIBUTE NULL_¥ALUE 


4. Enter information for the new attribute. 


Adding New ODBC Driver Attributes 


To add a new ODBC driver attribute: 


1. Select ODBC Resources from the checklist. The ODBC Resources View opens. 


Install ODBC_Resources.mst (Install ODBC_Resources.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


j>Gb@|DD|t+e>|Bax~ OSL!\O@ 


5- Package Validation t ODBC Resources 


Prevalidation 1) ODBC Data Sources 


4 Organization Fi dBASE Files 
Product Properties EA Excel Files 
$ Features Fi Flight32 

B- System Configuration A FoxPro Files 


a Files and Folders § mais 


Registry Fi MS Access 97 Database 


Shortcuts A My New DSN 1 
2 INI Files Fi my New DSN 2 
NT Services FA Text Files 
es H- ODBC Drivers 
5- Application Configuration H-E ODBC Translators 
g Server Locations 
[E] Setup Properties 
É} Dialogs 
Eal Add/Remove Programs 
5- Package Preparation 


Postvalidation 
Package 


5- Additional Tools 
E Direct Editor 
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ODBC Resources ¥iew 


Open Database Connectivity (ODBC) Resources are | Give Us Feedback 


ones that involve interaction with databases, Tuner 

allows you to view existing ODBC Data Sources, ODBC Drivers, 
and ODBC Translators. The left pane of the ODBC Resources view 
contains a tree with the three root nodes: ODBC Data Sources, 
ODBC Drivers, and ODBC Translators. When any of these are 
expanded, individual Data Sources, Drivers, and Translators 
contained in the Windows Installer package are displayed. When 
selected, each of these individual nodes displays information in a 
property grid displayed in the upper right pane. 


j Only ODBC Data Source attributes are editable; 
ODBC Drivers and ODBC Translators are provided 
in read-only form. 
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2. Select the ODBC driver to which you want to add a new attribute from the ODBC Resources tree. The 
property grid for the selected ODBC driver appears. 


Install_ODBC_Resources.mst (Install_ODBC_Resources.msi) - InstallShield Tuner Cc) 


|| Eile Edit Yiew Go Project Tools Help 


joen@|DD|*+e>|Bar\OSL!\e@ 
ODBC Resources =% 


‘a9 ODBC Resources MicrosoftExcelDriver 
H-E ODBC Data Sources Attribute ¥alue 
B-E ODBC Drivers File F1449_odbcjt32.dll 
Microsoft Access Driver (*.mdb) Setup File F1450_odexI32.dll 
Microsoft dBase Driver (*.dbf) Feature NewFeature1 
Microsoft Excel Driver (*.xIs} | APTLevel 
Microsoft FoxPro Driver (*.dbf) ConnectFunctions 
| Microsoft Text Driver (*.txt; *.csv) |__| DriverODBCV¥er 
My New Driver 1 FileUsage 
J My New Driver 2 FileExtns 
SQL Server || SQLLevel 
5- ODBC Translators 
(a MS Code Page Translator 


3. Right-click in the property grid and select Add from the context menu. A new attribute is listed, with the 
default values of ATTRIBUTE and NULL_VALUE. 


4. Enter information for the new attribute. 


Editing ODBC Data Source Attributes 


To edit an ODBC data source attribute: 


1. On the ODBC Resources View, select the ODBC data source that contains the attribute you want to 
modify from the ODBC Resources tree. The property grid for that data source appears. 


H ODBC Resources 
5- ODBC Data Sources 


FoxProFiles 
Attribute 


Yalue 


pal dBASE Files |_| Registration User Data Source 

Fi Excel Files |_| Driver Description Microsoft FoxPro Driver (*,dbF) 
EA Flight32 |__| Feature NewFeature1 

Fi FoxPro Files |_| SafeTransactions 

E mais _. UID 


Fi Ms Access 97 Database 
i my New DSN 1 
SA my New DSN 2 
pal Text Files 
B-E ODBC Drivers 
Microsoft Access Driver (*,m 
Microsoft dBase Driver (*.db 


2. In the properties grid, edit the appropriate attribute. 
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Editing ODBC Driver Attributes 


To edit an ODBC driver attribute: 


1. On the ODBC Resources View, select the ODBC driver that contains the attribute you want to modify 
from the ODBC Resources tree. The property grid for that ODBC driver appears. 


Install_ODBC_Resources.mst (Install_ODBC_Resources.msi) - InstallShield Tuner DER) 


| Eie Edit view Go Project Tools Help 


jaehHa|/DD|t+e>|Hax|OSL!|0@ 
ODBC Resources ® 


MicrosoftExcelDriver 
Attribute ¥Yalue 
5- ODBC Drivers il F1449_odbcjt32. dll 
Microsoft Access Driver (*.mdb) F1450_odexI32. dll 
Microsoft dBase Driver (*.dbF) T Feature NewFeature1 
Microsoft Excel Driver (*.xIs} | | APILevel 
Microsoft FoxPro Driver (*.dbF) |__| ConnectFunctions 
Microsoft Text Driver (*.txt; *.csv) DriverODBC¥er 
My New Driver 1 FileUsage 
J My New Driver 2 T FileExtns 
SQL Server |} SQLLevel 
S- ODBC Translators 
(a MS Code Page Translator 


2. In the properties sheet, edit the appropriate attribute. 


Removing Existing ODBC Data Sources 


To remove an existing ODBC Data Source: 
1. Select the ODBC Resources view from the checklist. 


2. Right-click on the ODBC data source you want to remove from the ODBC Resources tree and select 
Delete. 
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Removing ODBC Driver Attributes 
F 
B 
To remove an ODBC driver attribute: 
1. Select the ODBC Resources view from the checklist. 


2. Select the ODBC driver that contains the attribute you want to delete from the ODBC Resources tree. 


3. In the properties sheet, rightclick on the attribute you want to remove and select Delete. 


Removing ODBC Data Source Attributes 
ris 
a. 
To remove an ODBC data source attribute: 


1. Select the ODBC Resources view from the checklist. 


2. Select the ODBC data source that contains the attribute you want to delete from the ODBC Resources 
tree. 


3. In the properties sheet, rightclick on the attribute you want to remove and select Delete. 
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NT Services 


The NT Services view provides a way to change parameters for NT Services included in the base Windows Installer 
package. 


Setting NT Service Arguments 


To set NT service arguments: 
1. Select the NT Services from the checklist. The NT Services View opens. 
Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


|| Eile Edit Yiew Go Project Tools Help 


joeuna@|DD|t+e>|Bax|eoL!\e@ 


NT Services *3 


S- Package Validation ey Services ServiceInstallO 
fi Prevalidation By Name DefWatch 
IE Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
©) Features Interact with Desktop | No 
a © System Configuration Start Type Operating System Loader 
Files and Folders Error Control Ignore Error 
e Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
S- Application Configuration Arguments 
(4-4 Package Preparation Description 
-E Additional Tools Feature NortonéntivirusCorporateEditionFeature 


2. Double-click the current value in the properties grid and modify it as needed. 
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Setting NT Service Dependencies 


To set NT service dependencies: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


|| Eile Edit Yiew Go Project Tools Help 


joeua|DD|t+e>|Bax|eG.! os 


S- Package Validation Sey Services ServiceInstallO 
EZ Prevalidation By Name DefWatch 
IE} Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
©) Features Interact with Desktop | No 
=] © System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
4) Application Configuration Arguments 
(4 Package Preparation Description 
HE} Additional Tools Feature NortonaéntivirusCorporateEditionFeature 


2. Double-click the current Dependencies value in the properties grid and add the names of services or 
load ordering groups that must be started prior to this service. 


If the dependency is on a load ordering group, the service can start if at least one member of the load ordering group 
is running after an attempt is made to start all load ordering group members. 
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Setting the NT Service Description 


To set the NT service description: 
1. Select NT Services from the checklist. The NT Services View opens. 
TestNTSvcView.mst (TestNTSvcView.msi) - InstallShield Tuner 


| File Edit View Go Project Tools Help 


|o ensamt +e» mns toL! 


NT Services *# 


5- Package Validation By Services ServiceInstall1 
EA Prevalidation By ServiceInstall0 Name Install2 
4 Organization By ServiceInstall1 Display Name DInstall2 
Product Properties By Servicelnstall2 Service Type Service runs in its own process 
@) Features Sy Servicelnstall3 Interact with Desktop No 
S- System Configuration By Servicelnstall4 Start Type Manual 
a Files and Folders Error Control Normal Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group LoadOrder2 
INI Files Dependencies Installi[~][~] 
NT Services Start Name admin2 
ODBC Resources Password pass2 
4 Application Configuration Arguments arg2 
H- Package Preparation Description Test Service Install 2 
Hy Additional Tools Feature FeatureA 


2. Double-click the current Description value in the properties grid and modify it as needed. 


Setting the NT Service Display Name 


To set the NT service display name: 
1. Select the NT Services view from the checklist. 


2. Double-click the current Display Name value and modify it. The display name can be up to 256 
characters in length. 
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Setting the NT Service Error Control Level 


go 
B 
To set the NT service error control level: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner ©) 


| Eie Edit Yiew Go Project Tools Help 


| 
joeua@|DD|t+e>|Bax|eor!\e@ 


I Package Validation Services ServiceInstallO 
EE Prevalidation By Name DefWatch 
IE} Organization Sy ServiceInstall1 Display Name 
Product Properties Service Type 
® Features Interact with Desktop No 
a © System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
H-E Application Configuration Arguments 
H © Package Preparation Description 
H- Additional Tools Feature NortonéntivirusCorporateEditionFeature 


2. Double-click the current Error Control value in the properties grid to access the pop-up menu. The 
possible values are as follows: 


Value Description 

Ignore Error Logs the error and continues with service startup. 

Normal Error Logs the error, displays an error message, and continues with service startup. 

Critical Error Logs the error (if possible) and restarts the system with the last configuration known to 
be good. If the las-known-good configuration is the one that caused the error, fail the 
startup. 
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Setting the NT Service Load Order Group 


To set the NT service load order group: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


|| File Edit Yiew Go Project Tools Help 


joeua@|DD|t+e>|Bax|eGL! \O@ 


B- Package Validation Sey Services ServiceInstall0 
EZ Prevalidation By Name DefWatch 
IE} Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
©) Features Interact with Desktop | No 
a © System Configuration Start Type Operating System Loader 
Files and Folders Error Control Ignore Error 
9 Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
S- Application Configuration Arguments 
(4 Package Preparation Description 
HE} Additional Tools Feature NortonéntivirusCorporateEditionFeature 


2. Double-click the current Load Order Group value in the properties grid and modify it as needed. If this 
service does not belong to a group, leave this value blank. 
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Setting the NT Service Overall Install Result 


To set the NT service overall install result: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


|| File Edit Yiew Go Project Tools Help 


joeua|DD|t+e>|Bax|eOL! \08 


S- Package Validation Sey Services ServiceInstallO 
EZ Prevalidation By Name DefWatch 
IE Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
©) Features Interact with Desktop | No 
a © System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
(4) Application Configuration Arguments 
(4 Package Preparation Description 
HE} Additional Tools Feature NortonaéntivirusCorporateEditionFeature 


2. Double-click the current Overall Install value in the properties grid to access the drop-down menu. 


3. Select either Continue overall install if service fails to install or Fail overall install if service fails to install 
as this property's value. 
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Setting the NT Service Start Type 


(g> 


Bi 


To set the NT service start type: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DE 


| File Edit Yiew Go Project Tools Help 


|o enean t +e» mns toL! 


I) Package Validation 
E Prevalidation 
IE Organization 
Product Properties 
® Features 
B- System Configuration 
Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources 
H- Application Configuration 
(4-4 Package Preparation 
6- Additional Tools 


Services ServiceInstallO 


By ServiceInstall0 Name DefiWatch 


Sy ServiceInstall1 Display Name 


Service Type 

Interact with Desktop No 

Start Type Operating System Loader 

Error Control Ignore Error 

Overall Install Continue overall install, if service Fails to install 
Load Order Group 

Dependencies 

Start Name 

Password 

Arguments 

Description 

Feature NortonAntivirusCorporateEditionFeature 


2. Double-click the current Start Type value in the properties grid to access the drop-down menu. 


3. Select the desired Start Type from the following possible values: 


Property Description 

Automatic The service starts during system startup. 

Manual The service is only started when the service control manager calls the 
StartService function. 

Disabled The service is not started. 


Start at Boot Time 


The driver is started by the operating system loader. (Device driver only) 


Started by the System 


The driver is started by calling the lolnitSystem function. (Device driver only) 
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Setting NT Service Start Name and Password 


To set the NT service start name and password: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


| File Edit Yiew Go Project Tools Help 


joeua@|DD|t+e>|Bax|eGL! \O@ 


B- Package Validation Sey Services ServiceInstall0 
EZ Prevalidation By Name DefWatch 
IE} Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
© Features Interact with Desktop No 
a © System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
S- Application Configuration Arguments 
(4 Package Preparation Description 
HE} Additional Tools Feature NortonéntivirusCorporateEditionFeature 


2. Double-click the current Start Name value in the properties grid and provide the name under which this 
service will run. 


3. Click the current Password value in the properties grid and provide the password associated with the 
Start Name. 
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Setting the NT Service Type 


To set the NT service type: 


1. Select NT Services from the checklist. The NT Services View opens. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner ©) (mj 


| File Edit Yiew Go Project Tools Help 


joeuas|DD|t+e>|Bax|eGO.! \0@ 


B- Package Validation Sey Services ServiceInstall0 
EZ Prevalidation By Name DefWatch 
IE} Organization By ServiceInstall1 Display Name 
Product Properties Service Type 
® Features Interact with Desktop No 
a © System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
S- Application Configuration Arguments 
4} Package Preparation Description 
H-E Additional Tools Feature NortonantivirusCorporateEditionFeature 


2. Double-click the current Service Type value in the properties grid to access the drop-down menu. 
3. Select the desired Start Type from the following possible values: 


m Service that Runs in its Own Process 


m Service that Shares a Process with Others 


4. Optional: click the current Interact with Desktop value in the properties grid to access the drop-down 
menu and specify whether the service needs to interact with the desktop. 
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Working with Dialogs 


When customizing the Windows Installer package, you may want to disable particular panels that appear during the 
installation, administrative, patch, or maintenance sequences. You can do so from the Dialogs view. This view 
contains a list of each of the four installation modes (installation, administrative, maintenance, and patch), with the 
associated dialogs that appear as part of the UI sequence during the selected mode. You can enable or disable these 
dialogs by either the check box to the left of the dialog name, or by using the Show and Hide buttons. 


Hiding Dialogs During Ul Sequences 


To hide a dialog during a UI sequence: 
1. Select Dialogs from the checklist. The Dialogs View opens. 


TestNTSvcView.mst (TestNTSvcView.msi) - InstallShield Tuner DAR 


| Eie Edit Yiew Go Project Tools Help 


| 
joeu@|DD|t+er|Baxrx|\eGy 


5- Package Validation 
Prevalidation Installation Mode: 


a- Organization Installation Sequence Show Sequence 
Product Properties = ——— | 


D Features 

B- System Configuration 
B Files and Folders E SetupInitialization Properties 
es Registry E SetupProgress 


Dialogs: 


INI Files 


Sey NT Services Show 
fad ODBC Resources | 


B- Application Configuration | 


g Server Locations 

[E] Setup Properties 

©} Dialogs 

f Ea Add/Remove Programs 
(4) Package Preparation 
H-E Additional Tools Dialogs 


The Dialogs view allows you to selectively enable or disable dialogs that Give Us Feedback 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 
for the Windows Installer package. You can then click on the check box to the left of the 
dialog name to enable or disable it from display when users run the package in that 
mode. 


2. Using the Installation Mode list, select the Ul sequence containing the dialog you want to hide. 


3. From the Dialogs list, clear the check mark next to the dialog you want to hide. Alternatively, select the 
dialog from the list and either click Hide or press the Space Bar. 
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4. |f necessary set the properties for the dialog you are removing to preserve the Ul sequence integrity. 
The Dialog Properties Dialog automatically appears if it is necessary to edit properties. 


To restore dialogs in a UI sequence: 
1. Select Dialogs from the checklist. The Dialogs View opens. 


TestNTSvcView.mst (TestNTSvcView.msi) - InstallShield Tuner 


| File Edit View Go Project Tools Help 
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5- Package Validation 
E Prevalidation Installation Mode: 


5- Organization Installation Sequence Show Sequence 
Product Properties 


@ Features 
SE System Configuration 
Files and Folders E Setuptnitialization Properties 
2 Registry E SetupProgress 
Fy Shortcuts [tide ) 
-$ INI Files 
Sey NT Services Show 
(J ODBC Resources 
B- Application Configuration 
g Server Locations 
[E] Setup Properties 
É} Dialogs 
Ea Add/Remove Programs 
(4 Package Preparation 
H-E Additional Tools Dialogs 


The Dialogs view allows you to selectively enable or disable dialogs that 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 
for the Windows Installer package. You can then click on the check box to the left of the 
dialog name to enable or disable it from display when users run the package in that 
mode. 


Dialogs: 


2. Using the Installation Mode list, select the Ul sequence containing the dialog you want to restore. 


3. From the Dialogs list, check the box next to the dialog you want to restore. Alternatively, select the 
dialog from the list and either click Show or press the Space Bar. 
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Suppressing the License Agreement Dialog 


Using the Dialogs view, it is possible to suppress the license acceptance dialog. This involves both turning off its 


display, and providing the value that the setup will interpret as acceptance of the agreement. 


This procedure assumes the original Windows Installer setup was created using InstallShield DevStudio. If another setup 
authoring application was used, the names of dialogs and properties may not be the same. The same general 


procedure still applies. 


To use a transform to suppress display of the license acceptance dialog: 


1. Select Dialogs from the checklist. The Dialogs View opens. 


TestNTSvcView.mst (TestNTSvcView.msi) - InstallShield Tuner 


| File Edit View Go Project Tools Help 


joeune@ |DD|t +> |Bax|eor 


=) Package Validation 
E Prevalidation 
B- Organization 
Product Properties 
a) Features 
SE System Configuration 
Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources 
B- Application Configuration 
g Server Locations 
[E] Setup Properties 
£ Dialogs 
Ea) Add/Remove Programs 
(4 Package Preparation 
5- Additional Tools 


Installation Mode: 


Installation Sequence 


Dialogs: 


E Setuptnitialization 
E SetupProgress 


Dialogs 


Show Sequence 


Properties 


Show 


Preview 


The Dialogs view allows you to selectively enable or disable dialogs that 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 

for the Windows Installer package. You can then click on the check box to the left of the 

dialog name to enable or disable it from display when users run the package in that 


mode. 


2. Using the Installation Mode list, select the Ul sequence containing the LicenseAgreement dialog. 


Typically, this is only in the Installation Sequence. 
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3. Select the LicenseAgreement dialog from the Dialogs list and click Hide. 
4. When the Dialog Properties Dialog appears, change the AgreeToLicense value to Yes. 


5. Click OK to dismiss the dialog. 


When an end user runs the installation using this transform, the License Agreement dialog will not appear. 
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Disabling Custom Setups 


You can use the Dialogs view to prevent users from performing custom setups. However, this requires not only the 
elimination of the Custom Setup panel during installation, but also the Setup Types panel. Additionally, you must 
ensure you have configured the features you want installed, as your end user will have no way to override them. 


This procedure assumes the original Windows Installer setup was created using InstallShield DevStudio. If another setup 
authoring application was used, the names of dialogs and properties may not be the same. The same general 
procedure still applies. 


To use a transform to disable a custom setup: 


1. Select Dialogs from the checklist. The Dialogs View opens. 
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The Dialogs view allows you to selectively enable or disable dialogs that Give Us Feedback 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 
for the Windows Installer package, You can then click on the check box to the left of the 
dialog name to enable or disable it from display when users run the package in that 
mode, 


Installation Sequence 


Dialogs: 
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2. Using the Installation Mode list, select the UI sequence containing the SetupType dialog. Typically, 
this is only in the Installation Sequence. 


Select the SetupType dialog from the Dialogs list and click Hide. 
When the Dialog Properties Dialog appears, change the ADDLOCAL value to ALL. 
Click OK to dismiss the dialog. 


Select the CustomSetup dialog from the Dialogs list and click Hide. 


~~ ek oe SS o D 


When the Dialog Properties Dialog dialog appears, change the _BrowseProperty value to INSTALLDIR. 


8. Click OK to dismiss the dialog. 


When an end user runs the installation using this transform, the user will not have the option to perform a custom 
setup. 
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Editing Dialog Properties 


To edit properties for a UI sequence dialog: 


1. Select Dialogs from the checklist. The Dialogs View opens. 
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Properties 


The Dialogs view allows you to selectively enable or disable dialogs that Give Us Feedback 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 
for the Windows Installer package. You can then click on the check box to the left of the 


dialog name to enable or disable it from display when users run the package in that 
mode, 


2. Using the Installation Mode list, select the Ul sequence containing the dialog containing properties you 
want to edit. 


3. From the Dialogs list, select the appropriate dialog. 
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4. Click Properties. The Dialog Properties Dialog opens. 


Dialog Properties - Maintenance TypeDig 


— 
Properties 


E| Property ¥alue Comment 
g Typical 

Installing 

installs 


e You cannot hide dialogs which have null property values. These 
1 properties are necessary to establish a new dialog display 
sequence, and must be configured prior to hiding the dialog. 


The Properties button is only enabled when you have selected a dialog containing editable properties. 


5. From the Dialog Properties Dialog dialog, double-click the value cell for the property you want to edit. 


6. Change the property value as necessary, and click OK. 


Dialogs View vs. Command-Line Options 


Generally, you should use the Dialogs View when you are still planning on displaying some panels during UI 
sequences. Typically, you may want to remove the License Agreement panel or the ability for a user to perform a 
custom setup, and these can both be accomplished easily from the Dialogs View. 


However, consider using the Windows Installer command-line options (particularly /qn) when you want to eliminate 
the user interface entirely. 


When suppressing dialog display, it is important to consider some implications of your actions. Particularly, when 
removing a dialog from a user interface sequence, there may be properties normally set by that dialog. For example, 
the LicenseAgreement dialog has a radio button which can set a property to Yes or No, depending on whether you 
agree to the terms in the license. The value of this property also determines whether the installation should continue. 
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Therefore, if you remove the LicenseAgreement dialog from a sequence, you need to use the Dialog Properties Dialog 
to set the value of this property so the installation can continue. 


Beyond setting necessary properties, you also should consider how features are displayed. For example, you may want 
to disable custom setups via the transform file. However, you must ensure each feature you want installed is 
configured to be installed; your end users will have no way to override the choices by performing a custom setup. 


Configuring Additional Server Locations 


If you install from a network server, and if you install features to run from the server or that will be advertised for 
installation on their first use, the applications may need access to the server sometime after the initial installation. The 
applications may also require access to the server if a file is deleted or becomes corrupt, as the application can copy 
the problematic file(s) automatically from the server. 


Adding Additional Server Locations 


To add an additional server location: 


1. Select Server Locations from the checklist. The Server Locations View opens. 
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Additional Server Location Paths: 


To add a server to the Additional Server Locations Path list, click the Add button at the top 


left of the list. You can either browse to the server location, or enter it either as a drive letter 
path (X:\Office) or as a UNC path (\\ServerZ\ Office), If you specify a drive letter, it must be defined 
on the computer, 


The server path can contain environment variables, delimited with percent (%) marks. For example, 
\\Server1\#Home# \Office uses the Home environment variable. 


InstallShield Software Corporation © 2004 449 


AdminStudio 5.5 User Guide 9 Customizing Packages 


3. Enter or click the Browse (...) button and browse to the server location. 


The validity of the server location is determined when the installation needs to access the server remotely. In other 
words, if a server is not available, or if you added an invalid server, the entry will be ignored if the resource is needed. 


Modifying Server Locations 


gS 


Bi 
To modify an additional server location entry: 


1. Select Server Locations from the checklist. The Server Locations View opens. 
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Additional Server Location Paths: 


To add a server to the Additional Server Locations Path list, click the Add button at the top 
left of the list. You can either browse to the server location, or enter it either as a drive letter 

path (X:\Office) or as a UNC path (\\ServerZ\ Office). If you specify a drive letter, it must be defined 

on the computer, 


The server path can contain environment variables, delimited with percent (%) marks. For example, 
\\Server1\#Home# \ Office uses the Home environment variable. 


2. Select the server entry from the Addition Server Location Paths window and either edit the entry or use 
the Browse (...) button to browse to desired location. 
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Removing Server Locations 


To remove an additional server location: 


1. Select Server Locations from the checklist. The Server Locations View opens. 
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Additional Server Location Paths: 


To add a server to the Additional Server Locations Path list, click the Add button at the top 


left of the list. You can either browse to the server location, or enter it either as a drive letter 
path (X:\Office) or as a UNC path (\\Server2\Office). If you specify a drive letter, it must be defined 
on the computer. 


The server path can contain environment variables, delimited with percent (%) marks. For example, 
\\Server1\#Home# \Office uses the Home environment variable. 


2. Select the server entry from the Addition Server Location Paths window. 


3. Click the Remove Button. 
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Reordering Server Locations 


To change the order in which additional server locations are accessed: 


1. Select Server Locations from the checklist. The Server Locations View opens. 
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Additional Server Location Paths: 


To add a server to the Additional Server Locations Path list, click the Add button at the top 


left of the list. You can either browse to the server location, or enter it either as a drive letter 
path (X:\Office) or as a UNC path (\\ServerZ\ Office), If you specify a drive letter, it must be defined 
on the computer, 


The server path can contain environment variables, delimited with percent (%) marks, For example, 
\\Server1\#Home# \Office uses the Home environment variable. 


2. Select a server entry from the Addition Server Location Paths window. 


3. Depending on whether you want to promote the server location or demote it, click the up and down 
arrow buttons at the top right of the view: 


Baha 


You can also use the Alt+Up Arrow and Alt+Down Arrow keyboard shortcuts. 


4. Repeat with other server location entries as necessary. 
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Changing Add/Remove Program Settings 


The Windows 2000 and Windows XP Add/Remove Programs in Control Panel differs from the previous Windows 
operating systems in many ways. Depending on how the Windows Installer setup is configured, the user has the 
option of removing, repairing, or changing the installation with the click of a button. 


Windows 2000 and XP users are also able to access additional information in Add/Remove Programs in Control 
Panel not available on previous platforms. With this information, it is easier for your end users to find technical 
support links and phone numbers, product update information, and information about your company. 


Changing Add/Remove Programs Properties 


gi 


2 
Bi 
To change properties in the Windows 2000 or XP Add/Remove Programs: 
1. Select Add/Remove Programs from the checklist. The Add/Remove Programs View opens. 
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+- Package Preparation 


#1) Additional Tools This property, which corresponds to the ARPNOREPAIR property in the Setup | Give Us Feedback 
Properties view, provides a way to prevent users from running the application 
setup to repair missing or corrupt product files, 


When you double-click on the Value cell, No and Yes appear as choices in a combo box, 


This property refers to the repair option in Add/Remove Programs, and not to dialogs 
displayed when a setup is run in maintenance mode. 


2. Double-click the value for the property you want to change. 


3. Either enter the information into the properties grid, or use the drop-down menu to select a value. 
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Disabling the Modify, Remove, or Repair Buttons 


To disable the Modify, Remove, or Repair buttons in Windows 2000 or XP's 
Add/Remove Programs in Control Panel: 


1. Select Add/Remove Programs from the checklist. The Add/Remove Programs View opens. 
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This property, which corresponds to the ARPNOREPAIR property in the Setup 


Properties view, provides a way to prevent users from running the application 
setup to repair missing or corrupt product files, 


When you double-click on the Value cell, No and Yes appear as choices in a combo box, 


This property refers to the repair option in Add/Remove Programs, and not to dialogs 
displayed when a setup is run in maintenance mode, 


2. Double-click the appropriate Disable Modify/Remove/Repair Button property from the properties grid. 


3. Use the drop-down menu to change the value to No. 


Customizing Setup Properties 


Even though Tuner provides you views to customize many areas of the Windows Installer package, it may be 
necessary to edit property values that are not available elsewhere. The Setup Properties view exposes the entries in the 
properties table (the underlying structure of Windows Installer packages). You can also add your own custom 
properties here. 
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Adding Custom Setup Properties 


To add a new setup property: 


1. Select Setup Properties from the checklist. The Setup Properties View opens. 
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Setup Properties @ 


Right-click in the properties grid and select Add. A New property is added to the bottom of the list with 
the a Property Name of NEW_PROPERTY and a Value of NULL_VALUE. 


Provide a new name for your property. If you want to change it later, click on the property name to edit 


it. 


Enter the property's value. 
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Adding and Editing Comments 


Tuner supports the ability to add comments to each property available in the Setup Properties view. This provides a 
way to clarify what specific properties do, and to enter any important information that you may need later. The 
original software vendor may have used InstallShield DevStudio to include comments in the original Windows 
Installer package. 


N 
d j- 


To add or edit a comment for a property: 
1. Select the Setup Properties view from the checklist. 
2. Double-click in the comment column for the property to which you want to add or edit the comment. 


3. Add or edit the comment as appropriate. 
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Removing Custom Setup Properties 


To remove a custom setup property: 


1. Select Setup Properties from the checklist. The Setup Properties View opens. 
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2. Right-click on the property you want to remove and select Delete. 


3. Confirm the deletion. 
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Modifying Setup Properties 


To modify the property value of a setup: 


1. Select Setup Properties from the checklist. The Setup Properties View opens. 
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2. Select the property that you want to modify. 


Modify Setup Properties 
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3. Double-click the property's value and edit it in the grid. 


Make sure you are entering valid values when you modify properties, otherwise validation or installation errors may 


result. 
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Preparing Packages for Distribution 


The final step in creating a customization involves two parts. First, you should postvalidate your transform and base 
Windows Installer package. This ensures that you have not introduced any errors into the installation, and may help 
you verify that you have corrected errors that existed in the base package. Secondly, you need to actually package the 
transform and base package for distribution. These tasks are accomplished using the Postvalidation view and Package 
view, respectively. 


Copying the Installation to a Network Location 


(g> 
2 


Bi 


To copy your installation to a Network location during packaging: 


1. From the checklist, select Package, and then select Location from the second column. The Location View 
of the Package View opens. 
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S- Package Preparation This view allows you to specify the location to store the installation 


4) Postvalidation files (including transforms), If you select Network Location, you can 
R Package specify or browse to the directory location, You can also perform an Administrative 
S- Additional Tools Install to this network location by checking the appropriate check box. 


E Direct Editor 


Alternately, you can distribute the installation files to an FTP server. If you select this 
option, you must specify the FTP location (URL), the user name under which to log in, 
and the password. 


2. Select the Network Location option button. 


3. Specify the network location, or click Browse to locate it. 


When you create your package, the appropriate files will be copied to the network location you specified. 
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If the transforms are copied to the same location as the original MSI, only the transform, setup.exe, setup.ini, and 
Windows Installer engines are copied. 


Copying the Installation to an FTP Server 


To copy your installation to an FTP server during packaging: 


1. From the checklist, select Package, and then select Location from the second column. The Location View 
of the Package View opens. 
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FTP Location 


Alternately, you can distribute the installation files to an FTP server. If you select this 
option, you must specify the FTP location (URL), the user name under which to log in, 
and the password, 


2. Select the FTP Server option button. 


3. Specify the FTP server name (FTP Location), the UserName, and Password for the FTP server. 


When you create your package, the appropriate files will be copied to the FTP server you specified. 
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Creating a Package Definition File (PDF) 


To create a Package Definition File (PDF): 


9 Customizing Packages 


1. From the checklist, select Package, and then select SMS from the second column. The SMS View of the 


Package View opens. 
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4 package definition file is a text file that contains all the information necessary to create a 
software distribution package for an application. SMS 1.2 or earlier uses PDF file extension. 


SMS 2.0 or later uses SMS file extension. 
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All options in this view relate to the Microsoft Systems Management 


Server (SMS) environment and preparing your base Windows Installer 

package and transform(s) for distribution using SMS, You can create a Package 
Definition File (PDF) to use with SMS 1.2 or earlier, or an SMS file for SMS 2.0 or 
later, If you are creating an SMS file, provide values for the Install MIF Filename, 
Uninstall MIF Filename, and Serial Number fields. Tuner will instruct SMS to 
automatically create a Management Information Format (MIF) file in the Windows 


directory at deployment time. 


2. Select the Create Package Definition File check box. 
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When you create your package, the resulting file has a .PDF extension. Here is a sample ORCA.PDF file: 


[PDF] 
Version=1.0 


[Package Definition] 

Product=Orca 

Version=1.20.1827.1 
Comment=Microsoft 
SetupVariations=Typical, Automated 


[Typical Setup] 

CommandName = Typical Installation 
CommandLine = msiexec /i Orca.msi 
UserInputRequired = TRUE 
SynchronousSystemExitRequired = TRUE 
SupportedPlatforms = Win 9x, Win NT (1386) 


[Automated Setup] 

CommandName = Automated Installation 
CommandLine = msiexec /i /q Orca.msi 
UserInputRequired = FALSE 
SynchronousSystemExitRequired = TRUE 
SupportedPlatforms = Win 9x, Win NT (7386) 


[Setup Package for Inventory] 
InventoryThisPackage=FALSE 
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Creating an SMS File 


To create a SMS file for SMS 2.0 or later: 


1. From the checklist, select Package, and then select SMS from the second column. The SMS View of the 
Package View opens. 
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Shortcuts environment, you can create an .MIF file in the Windows directory to describe 
T$ INI Files your application, MIF stands for Management Information Format. 


NT Services Install MIF Filename 
ODBC Resources 


=) Application Configuration Uninstall MIF Filename 
g Server Locations 
[E] Setup Properties 
E Dialogs 
a) Add/Remove Programs 
5- Package Preparation 


Postvalidation 
Package 
5- Additional Tools All options in this view relate to the Microsoft Systems Management Give Us Feedback 


=: Direct Editor Server (SMS) environment and preparing your base Windows Installer 
package and transform(s) for distribution using SMS, You can create a Package 
Definition File (PDF) to use with SMS 1.2 or earlier, or an SMS file for SMS 2.0 or 
later. If you are creating an SMS file, provide values for the Install MIF Filename, 
Uninstall MIF Filename, and Serial Number fields. Tuner will instruct SMS to 
automatically create a Management Information Format (MIF) file in the Windows 
directory at deployment time. 


2. Select the Create SMS file check box. 


InstallShield Software Corporation © 2004 463 


AdminStudio 5.5 User Guide 9 Customizing Packages 


When you create your package, the resulting file has an SMS extension. Here is a sample ORCA.SMS file: 


[PDF] 
Version=2.0 


[Package Definition] 

MIFFi lename=Sample.MIF 

Name=Orca 

Publisher=Microsoft 
Version=1.20.1827.1 
Language=English 
Programs=Typical, Automated, Test 


[Typical] 

Name = Typical 

CommandLine = msiexec /i Orca.msi 

UserInputRequired = TRUE 

Uninstal 1Key={8FC71000-88A0-4B41-82B8-8905D4AA904C} 
AfterRunning=ProgramRestart 

Supportedclients = Win 9x, Win NT (1386) 


[Automated] 

Name = Automated 

CommandLine = msiexec /i /q Orca.msi 
UserInputRequired = FALSE 

Uninstal lKey={8FC71000-88A0-4B41-82B8-8905D4AA904C} 
AfterRunning=ProgramRestart 

SupportedClients = Win 9x, win NT (i386) 


[Test] 

Name = Test 

CommandLine = msiexec /i Orca.msi EXECUTEMODE=None 
UserInputRequired = FALSE 
AfterRunning=ProgramRestart 

Supportedclients = Win 9x, Win NT (1386) 
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Instructing SMS to Create a Management 
Information Format File at Deployment Time 


To instruct SMS to create a Management Information Format (MIF) file at deployment 
time: 


1. From the checklist, select Package, and then select SMS from the second column. The SMS View of the 
Package View opens. 


| 
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Package Definition File 
A package definition File is a text File that contains all the information necessary to create a 
software distribution package for an application. SMS 1.2 or earlier uses PDF file extension, 
SMS 2.0 or later uses SMS file extension. 


C] Create Package Definition File (SMS 1.2 or earlier) 
Create SMS file (SMS 2.0 or later) 


If your installation will be run in a Microsoft Systems Management Server (SMS) 
environment, you can create an MIF file in the Windows directory to describe 
your application, MIF stands for Management Information Format. 


Install MIF Filename | 


Uninstall MIF Filename | 


All options in this view relate to the Microsoft Systems Management 
Server (SMS) environment and preparing your base Windows Installer 

package and transform(s) for distribution using SMS. You can create a Package 
Definition File (PDF) to use with SMS 1.2 or earlier, or an SMS file for SMS 2.0 or 
later. If you are creating an SMS file, provide values for the Install MIF Filename, 
Uninstall MIF Filename, and Serial Number fields. Tuner will instruct SMS to 
automatically create a Management Information Format (MIF) file in the Windows 
directory at deployment time. 


2. Select the Create SMS file checkbox. 


3. Provide the name of the application you are installing in the Install MIF Filename field. 


4. Provide the name of the application to be uninstalled in the Uninstall MIF Filename field. 


5. Enter the serial number for the product in the Serial Number field. 


The resulting file has a .MIF extension. 
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Deploying Windows Installer Setup Packages with 
Systems Management Server 2.0 

Bi 

To deploy Windows Installer setup packages with SMS 2.0: 


Perform the steps detailed in the Microsoft White Paper: Deploying Windows Installer Setup Packages 
with Systems Management Server 2.0. 


Creating a Setup.exe File for the Package and 
Transform 


fae 


Bi 


To create a Setup.exe file to begin the installation of your base package and transform: 


1. From the checklist, select Package, and then select Setup from the second column. The Setup View of 
the Package View opens. 
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Package 
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Direct Editor Ej For a comprehensive list of Windows Installer command-line arguments, 
refer to the Command-Line Options topic in the MSI Help. 
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2. Select the Create Installation Launcher (Setup.exe) check box. 
3. Specify whether you want to include the Windows 95/98 or Windows NT MSI engines. 
4. Provide any command-line arguments for your installation. 


5. Save your transform. The Setup.exe file is stored in the directory specified in the Location panel of the 
Packaging Wizard, or in the Location view within the Package view. 


Additional Setup.ini Parameters 


You can modify the Setup.ini file generated by Tuner for added functionality. The following two parameters can be 
included in the [Startup] section of the Setup.ini: 


Parameter Description 


SuppressWin2k If you add this line and set its value to "Y" or "y" (SuppressWin2k=Y or SuppressWin2k=y), 
Setup.exe will not display a message on the target system stating that an older version of 
Windows Installer is installed. 


SuppressReboot If you add this line and set its value to "Y" or "y" (SuppressReboot=Y or SuppressReboot=y), 
Setup.exe will delay the reboot typically required by the installation of a newer version of 
Windows Installer on the target machine. If the application's setup requires a reboot, this will 
occur normally. 
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Directly Editing Packages 


Windows Installer packages are relational databases consisting of dozens of interrelated tables. These tables reflect the 
application's features, components, relationship between features and components, registry information, and user 
interface. 


The Direct Editor allows you to edit values in the MSI tables of the base Windows Installer package and store them in 
your transform. As you change values elsewhere in your transform, those changes are reflected in the Direct Editor, 
and vice versa. The complete list of MSI tables contained in the installation package is displayed in the left pane. 
When you select a table, the contents are displayed in the right pane. 
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Resizing Table Columns in the Direct Editor 


When you initially open the Direct Editor, the selected table's columns are listed in a compact format so that the 
maximum number of columns are displayed. 


To automatically resize a column so that its width matches that of its longest entry, double-click on the column 
heading. This new column width setting is automatically saved and will be implemented the next time you view this 
table column in the Direct Editor. 


Sorting Table Columns in the Direct Editor 


To sort a table column, click the column heading once. The order will toggle between ascending and descending. 
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Adding a New Record Using the Direct Editor 


To add a new record in the Direct Editor: 
1. Select Direct Editor from the checklist. The Direct Editor opens. 
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2. Select the table you want to add a row to from the table tree. 


3. Click on the last row in the table's grid, or click anywhere in the table and press the Insert key. 


A new record is added to the grid using a unique key for the record (use ColumnName<n> as the 
template). You can then modify the record. 


To ensure files are deployed on the target system, add files in the Files and Folders View, rather than to the file table. 
Files added to the File table are not physically added to the transform. 
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The Direct Editor supports find and replace throughout all tables. The following commands are available: 


Command Description 

Find (Ctrl+F) Displays a standard Find dialog and allows you to search for a string in all tables. 

Find Next (F3) Allows you to search for the next occurrence of a given string in all tables. 

Replace (Ctrl+H) Displays a standard Search and Replace dialog and allows you to search for data in all the MSI 
tables and gives you the option to replace the data. 


Launching the Direct Editor from the Validation 
Tab 


When performing a Prevalidation or Postvalidation, the Validation tab is automatically selected, and all of the Errors, 
Warnings, and Info messages that were generated are listed in table format. Each table row lists an icon to indicate 
whether it is an Error © Warning A ot Informational message Y the name of the ICE that generated it, and a 
brief description of what caused it to occur. 


E KE Type Description A 
ERROR Invalid Filename; Table: File, Column: FileName, Key{s): esdupdate.dll J 
WARNING Component: Distiller_Win_NT_System_files is a non-permanent system component 
WARNING Component: Distiller_Win9X_System_Files is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9xX is a non-permanent system component w5 

j | > 
Validation Á Packaging F 
Ready NUM 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. This feature makes it 
very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows Installer package and 
store them in your transform. 
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Resizing Table Columns in the Direct Editor 


When you initially open the Direct Editor, the selected table's columns are listed in a compact format so that the 
maximum number of columns are displayed. 


To automatically resize a column so that its width matches that of its longest entry, double-click on the column 
heading. This new column width setting is automatically saved and will be implemented the next time you view this 
table column in the Direct Editor. 
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Sorting Table Columns in the Direct Editor 


To sort a table column, click the column heading once. The order will toggle between ascending and descending. 
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Tuner Reference 


Reference information for Tuner is divided into the following sections: 


Tuner Reference 


User Interface Reference 


€ 


Contains general information about the Tuner user interface, including menus, toolbars, keyboard shortcuts, 
windows, and dialog boxes. 


Views 


€ 


Contains detailed reference information about each Tuner view. 


Import INI File Wizard 


€ 


Provides reference information for the Import INI File Wizard. This is the same information accessible by clicking 
Help in the Wizard. 


Import REG File Wizard 


Provides reference information for the Import REG File Wizard. This is the same information accessible by 
clicking Help in the Wizard. 


€ 


Packaging Wizard 


€ 


Contains panel-by-panel reference information for the Tuner Packaging Wizard. Also includes information about 
additional Setup.ini options. 
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User Interface Reference 


This book describes the user interface components, such as menu items, the toolbar, views, and dialog boxes you will 
encounter throughout Tuner. 


These topics are the same detailed documentation that is displayed when you press the F1 key or click the Help 
button while working in a dialog. 


Menus and Toolbar 


The Tuner user interface has several menus, each of which contain different commands. The functionality of each 
command is described below. Additionally, the Toolbar provides quick access to some of the frequently used 
commands; the corresponding toolbar buttons are listed with the appropriate commands. 


Toolbar 
Menu Command Shortcut Button Description 
File New Ctrl+N E Takes you to the Create a New Transform File area of 
x 

the InstallShield Today view. 

File Open Ctrl+O Lh Takes you to the Open a Recent Transform File area of 
the InstallShield Today view. 

File Close Closes the currently open transform file. 

File Save Ctrl+S rl Saves the current transform file. 

File Save As Prompts you to name the transform file you are saving. 

File Properties Displays properties for the current transform, including 
the name and location of the base Windows Installer 
package. 

File [1], [2], Allows you to select one of the four most recently 

[3], or [4] accessed transforms. 

File Exit Exits Tuner. 

Edit Undo Ctrl+Z Undoes the last action. 

Edit Cut Ctrl+X Removes the selected text to the clipboard. 

Edit Copy Ctrl+C Copies the selected text to the clipboard. 

Edit Paste Ctrl+V Pastes the contents of the clipboard to the current 
cursor location. 

View Output Window Toggles the Output window. 
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Toolbar 

Menu Command Shortcut Button Description 

View Check List Lh Toggles the checklist. 

View View Bar Lh Toggles the View Bar. 

View Header Bar Toggles the Header Bar. 

View Toolbar Toggles the Toolbar. 

View Status Bar Toggles the Status Bar. 

Go Previous View Le Takes you to the previous view in the checklist. 

Go Next View LE Takes you to the next view in the checklist. 

Go Back LA Moves you to the last view. 

Go Forward LH Moves you to the next view. 

Go InstallShield Takes you to the InstallShield Today view. 
Today 

Go Help Takes you to the Help view. 

Go Prevalidation Takes you to the Prevalidation view. 

Go Product Takes you to the Product Properties view. 
Properties 

Go Features Takes you to the Features view. 

Go Files and Takes you to the Files and Folders View. 
Folders 

Go Registry Takes you to the Registry view. 

Go Shortcuts Takes you to the Shortcuts view. 

Go INI Files Takes you to the INI Files view. 

Go NT Services Takes you to the NT Services view. 

Go ODBC Resources Takes you to the ODBC Resources view. 

Go Server Locations Takes you to the Server Locations view. 

Go Setup Properties Takes you to the Setup Properties view. 
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Toolbar 
Menu Command Shortcut Button Description 
Go Dialogs Takes you to the Dialogs view. 
Go Add/Remove Takes you to the Add/Remove Programs view. 
Programs 
Go Postvalidation Takes you to the Postvalidation view. 
Go Package Takes you to the Package view. 
Go Direct Editor Takes you to the Direct Editor. 
Project MSI Validation Runs prevalidation on the MSI file. 
Project Transform Bi Runs postvalidation on the MST file. 
Validation 
Project Transform Launches the Transform Summary dialog. 
Summary 
Information 
Project Test Ctrl+T Lk Allows you to test your custom installation without 
actually installing. 
Project Run Ctrl+F5 l; Performs the actual installation of the Windows 
Installer package and your transform. 
Project Package E Packages the transform and Windows Installer 
package based on the current packaging settings. 
Project Packaging Ctrl+F7 Li] Launches the Packaging Wizard. 
Wizard 
Project Stop Ej Halts in-progress validation or packaging. 
Tools Customize Allows you to customize toolbars and menus. 
Tools Options Allows you to specify the default locations for MSI and 
MST files. 
Help Help Library L Launches the online help (which you are currently 
viewing). 
Help Tutorial Takes you to the main tutorial view. 
Help MSI Help Brings up the MSI online help. 
Help ReadMe Displays the AdminStudio ReadMe file. 
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Menu Command Shortcut Description 
Help InstallShield Takes you to the InstallShield Web site. 
on the Web 
Help About Displays information about Tuner, including the 
InstallShield version and copyright notice. 
Tuner 
View Bar 


The View Bar, when visible, is located at the far left of the user interface. It provides quick shortcuts to important 
areas of Tuner, and can be toggled on and off using the View Bar command under the View menu, or from the 
corresponding toolbar button. 
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There are three different View Bars available: 
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InstallShield 


Checklist Steps 


Views 


This View Bar gives you quick access to 
the InstallShield Today view and the 
Help view. 


This View Bar provides access to each 


of the checklist steps, which include 
Package Validation, Organization, 
System Configuration, Application 
Configuration, Package Preparation, 
and Additional Tools views. 


This View Bar gives you quick access to 
each view in Tuner. 
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Checklist 


The checklist is a graphical tree that shows you all of the views available in Tuner, as well as their association with 

other views. When you select a view, it appears in the pane to the right of the checklist; you can then customize the 
part of the Windows Installer package pertaining to that view. The Customization Steps Checklist is a subset of the 
entire checklist. 


The checklist can be toggled from the View menu and from the Toolbar. 


Checklist 4 


Orca1.mst (Orca.msi) - InstallShield Tuner 


#4 Prevalidation 


@% InstallShield Today 
©) Help 
=) Package Validation 


fal Prevalidation 


B- Organization 


Installer Package: C:\Aad 


Product Properties Evaluation File: Full lv 
©) Features EER F 
B- System Configuration OM 


2 Files and Folders 
@ Registry 
OY Shortcuts 
“$ INI Files 
Sa NT Services 
ODBC Resources 
B- Application Configuration 
g Server Locations 
[E] Setup Properties 
&} Dialogs 
i Ea Add/Remove Programs 
H- Package Preparation 
H-E Additional Tools 


C] Show "INFO" messages 


¥alidation 


To configure validation, fii 
against, or click Browse i 
evaluation files. Although 
{separated by semicolons 


You can select the level o 
Info, Warning, or Error ch 


Customization Steps Checklist 


9 Customizing Packages 


To assist you with your customization, Tuner provides you with a set of steps that cover all parts of the MSI file that 
can be customized in your transform project. You do not have to follow these steps in sequential order, or even 
complete all the steps. Below is a brief description of each step, and how they fit into the customization workflow. 


Step 


Description 


Prevalidation 


This step allows you to pre-check the base Windows Installer package to ensure it is valid 


according to MSI standards before you take the time to create the transform file. If it is invalid, there 
may be unexpected results with your installation. Tuner allows you to copy the results of the 
prevalidation to the clipboard, where you can paste them into a message to the application's 
vendor. This is one of the most important steps in the Tuner workflow. Without it, all of your work 


might be wasted. 
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Step Description 

Organization This allows you to specify both the default destination that the installation will suggest, as well as the 
suggested default company name. You also can modify some properties of individual features in the 
product. 

System This is where Tuner shows you its true customization power. You can add files and registry entries 

Configuration to the installation, allowing you to add company-specific files, templates, etc. to the installation. For 
example, if you have a set of word processing templates your company uses, you can include them 
you can modify or remove existing shortcuts, or add your own as necessary. 

Application This step allows you to change functionality for Add/Remove Programs in Control Panel for 

Configuration Windows 2000 and later. You can also see the full spectrum of MSI properties as they exist in the 
base Windows Installer package, and add, modify, or remove them as necessary. Additionally, 
you can configure source resiliency through the Server Locations view, and customize user interface 
sequences through the Dialogs view. 

Package This step allows you to postvalidate your project, verifying the original Windows Installer package 

Preparation and transform file, meets MSl-validation standards. You also can select the distribution options, 
including ones for network, FTP, single-executable, and SMS distributions. 


Output Window 


When you prevalidate the base Windows Installer package, postvalidate the package and your transform, or package 
the transform and base package, the Output Window appears at the bottom of the interface. It consists of three tabs: 


= Output—Lists the Errors and Warnings and Informational messages that are generated during prevalidation, 
postvalidation, and packaging. 


E Validation—Upon completion of the pre- or postvalidation, this tab is automatically selected, and all of the 
Errors, Warnings, and Info messages that were generated are listed in table format. Each table row lists an icon to 


indicate whether it is an Error © Warning A or Informational message , the name of the ICE that generated 
it, and a brief description of what caused it to occur. 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct 
Editor is launched and the table and/or table cells that are causing the problem are highlighted in red. You can 
then use the Direct Editor to edit values in the MSI tables of the base Windows Installer package and store them 


in your transform. 


E Packaging—Displays packaging/distribution information, and displays a summary of the files copied. You can 
copy these results to the clipboard by right-clicking and selecting Copy. 


The Output Window can be toggled from the View menu. 
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9 Customizing Packages 


The Customize Dialog box allows you to customize which toolbars are available in the Tuner user interface, as well as 
the buttons that are available on the toolbars. The dialog box consists of two tab panels: 


Toolbars Tab 


Command Tab 


buttons found in the Command tab panel. 


From the Toolbars panel, you can select viewing properties 
for all toolbars, such as whether tooltips are displayed, the 
style of the toolbar, and the size of the buttons. You can also 
create your own custom toolbar, onto which you can place 


The Command panel allows you to customize toolbars and 
the menu bar. Simply drag the command or menu you want 
to add to the existing toolbar; it appears where you place it. 
To remove a command or menu, select it and drag it off the 
toolbar. 


Customize 


Toolbars | Command 


Toolbars: 


Menu bar | Show Tooltips 
v]Default Cool Look 


C Large Buttons 


Customize 


| ‘Toolbars: | Command 


Categories: Buttons 


E bene DO tye 
Has su: os 


Extra 
Menu 


Select a category, then click a button to see its description. Drag the button 
to any toolbar 


Description 
Package a distribution unit for the active project 
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Properties Dialog Box 


This dialog displays properties of the transform you are currently creating or editine—including the name and location 
of the base Windows Installer file, and any additional transforms that are associated with this transform and MSI file. 


Properties 


General 


oh PackageForTheWeb 4.mst 


Location: C:\AdminStudio Shared 
Size: 3.50KB (3584 bytes) 
Base MSI: C:\AdminStudio Shared\PackageForThewWeb 4.msi 


Created: Wednesday, July 16, 2003 11:10:39 AM 
Modified: Wednesday, July 16, 2003 11:10:39 AM 
Accessed: Wednesday, July 16, 2003 


Additional Transforms: 


Options Dialog Box 


The Options dialog box has two tabs: File Locations and View Settings. 
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File Locations 


Within the File Locations tab, you can specify the default location of your source MSI files. This is reflected in the 
New Transform and Open Existing Transform view of the InstallShield Today view. 


Options 


File Locations | view Settings | 


MSI Location 


a Specify the folder where MSI packages will be stored by default. This will be 
1B used as the default path when browsing For MSI files. 


MSI Location: 


| ocuments and Settings\PatriciaHowe\My Documents\My Customization | 


Browse... 
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View Settings 


From the View Settings tab, you can select whether you want to display files from the base Windows Installer package 
(MSD in the Files and Folders view in addition to files added in the transform. 


Options 


| File Locations View Settings 


Files View 
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Transform Summary Dialog 


The Transform Summary dialog, available from the Project menu, allows you to configure how to handle specific 
errors when the transform is applied. Additionally, you can configure how the Windows Installer Service verifies 
whether the transform can be applied against a given package. 


Transform Summary 


Summary Information 


Suppress Errors: 

When applying this transform, ignore the Following Failures: 
Dik [C] Delete Missing Table 
[C] Delete Missing Row [C] Modify Missing Row 
C] Add Existing Table C] change Codepage 


Validation: 


Before applying this transform, verify that the database meets 
the Following conditions: 


oO Same Lanquage og Product Version is Lower 
Same Product Code [C] Product Version is Equal 
C] Same Upgrade Code [C] Product Version is Higher 


When checking the product version, use only 


O None 


© Major Version 
© Major and Minor Versions 


OMajor, Minor, and Update Versions 


Version # 
Version #.# 
Version #.#.# 


Options in this section allow you to configure whether installations with this transform applied will continue or fail if 
certain errors are encountered. You can configure the following options: 


Option Description 

Add Existing Row Suppresses errors resulting from adding rows that already exist. 
Delete Missing Row Suppresses errors resulting from deleting rows that do not exist. 

Add Existing Table Suppresses errors resulting from adding existing tables. 

Delete Missing Table Suppresses errors resulting from deleting tables that do not exist. 
Modify Missing Row Suppresses errors resulting from updating rows that do not exist. 
Change Code Page Suppresses errors resulting from mismatched code pages. 
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Validation Options 


Options in this section allow you to specify how the Windows Installer Service verifies the transform can be applied 
to a Windows Installer package. You can configure the following options: 


Option Description 


Same Language If selected, the package against which the transform is applied must be the same language as 
the package used to create the transform. 


Same Product Code If selected, the product code for the package against which the transform is to be applied 
must be the same as the package product code of the package used to create the transform. If 
not selected, you can create a generic transform that can be applied against multiple 
Windows Installer packages. 


Same Upgrade Code If selected, the upgrade code of the package against which the transform is applied must be 
the same as the upgrade code of the package used to create the transform. 


Product Version is If selected, the product version must be less than the version of the package used to create the 
Lower transform. This can be combined with the Product Version is Equal option to create a "less 
than or equal to" comparison. 


Product Version is Equal |f selected, the product version must be equal to the version of the package used to create the 
transform. This can also be combined with either the Product Version is Lower option or the 
Product Version is Higher option, creating a "less than or equal to" or "greater than or equal 
to" comparison. 


Product Version is If selected, the product version must be greater than the version of the package used to create 
Higher the transform. This can be combined with the Product Version is Equal option to create a 
"greater than or equal to" comparison. 


Version Checking When using product version comparisons, you must indicate to what degree you want the 
comparison made. You can compare only the major versions, the major and minor versions, 
or the major, minor, and update versions. You can also select None to clear version checking. 
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You can use the Dialog Properties dialog to view or change properties associated with UI sequence dialogs. The 
Dialog Properties dialog is accessible by either selecting the appropriate dialog in the sequence and clicking Properties, 
ot if you attempt to hide a dialog which has properties that must be configured. 


Dialog Properties - MaintenanceTypeDlig 


—_——_ 
Properties | 


Property ¥alue Comment 
allMode Typical 
gr Installing 

55 installs 


mi 
— 
— 
— 
— 


e You cannot hide dialogs which have null property values. These 
1 properties are necessary to establish a new dialog display 
sequence, and must be configured prior to hiding the dialog. 


You must ascertain the purpose of each property from the Windows Installer package, as these properties are usually 
custom in nature. This is especially true for properties that must be set prior to hiding a dialog from the UI sequence. 


You cannot hide UI sequence dialogs until you provide values for all currently null properties. These values are 
necessary to establish a new dialog display sequence. Each property which must be configured prior to hiding the 
dialog in the sequence is marked with Ll]Either configure the null properties, or click Cancel to return to the Dialogs 
view. Typically, configuring a null property involves clicking in the property's value field and selecting the value from 
the drop-down list. 


Once you have provided a value for a null property, or if the property does not require configuration, it is denoted 


with Ly 
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Views 


InstallShield Today 


The InstallShield Today view allows you to create a new transform project or open an existing one. This view also 
provides you with quick access to information about Tuner. 


InstallShield Tuner 


| File Edit View Go Project Tools Help 


jpaeHa@|DO|t+e> maxs eo! (eos 
A InstallShield Today 
InstallShield Tuner 


Pay Welcome 
Welcome to InstallShield Tuner Welcome to InstallShield Tuner 


[Create a new transform If you receive software in the MSI format, AdminStudio allows you to build 
F Transforms to adapt the installation to the needs of your environment, 

Create a new transform file (.mst) AdminStudio's Tuner module generates Transforms (.MST files) providing the 
only Microsoft-recommended way to customize Windows Installer packages 
for deployment. Either step through the installation sequence to catch all of 
your preferred settings, or open up the MSI and easily make your changes. 

Open a recent transform file (.mst) Customizations such as removing or relocating shortcuts, changing registry 

settings, adding files, pre-configuring ODBC databases, or creating a Ls 
So isting t f response file are all easily made through a clean interface that removes most 
pen an existing Cransrorm of the complexity of working with a typical setup. Using Tuner, you can easily 

Open an existing transform File (.mst) and quickly customize Windows Installer packages to meet your 

organization's needs, including limiting the features installed, adding custom 
files to the installation, and setting property values. You can also make 
@ installshield on the Web multiple customizations from the same base setup, drastically reducing the 
time to deployment. The result is an easy and intuitive way to ensure an 
installation is really your installation. 


x| 
a MSI Validation Á Transform Validation A Packaging A Output 7 


Ready NUM 


B Open a recent transform 


Explore InstallShield's Internet resources 


The InstallShield Today view contains the following links: 


mE Welcome—General information about Tuner. 


m Create a New Transform File—Create a new customization, either starting with a blank transform, or by 
using a Response Transform based on selections from a custom installation. 


E Open a Recent Transform File—Select a transform previously created with Tuner. 


= Open an Existing Transform File—Select a transform created with a tool other than Tuner. You need to 
provide additional information, such as the base Windows Installer package for this transform. 


E InstallShield on the Web— Access helpful links to InstallShield information. 
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Welcome to InstallShield Tuner View 


The Welcome view provides you with links to information on the Windows Installer service, Microsoft's integrated 
method of handling installations, as well as information about InstallShield Tuner in the form of checklist steps. These 
steps cover the customization capabilities of InstallShield Tuner. 


InstallShield Tuner 


| File Edit View Go Project Tools Help 


joeu@|DO|\t++>|\Zaxrx|\O9Gr!\og 
A InstallShield Today 
InstallShield Tuner 


Pay Welcome 
Welcome to InstallShield Tuner Welcome to InstallShield Tuner 


[Create a new transform If you receive software in the MSI format, AdminStudio allows you to build 
F Transforms to adapt the installation to the needs of your environment, 

Create a new transform file (.mst) AdminStudio's Tuner module generates Transforms (.MST files) providing the 
only Microsoft-recommended way to customize Windows Installer packages 
for deployment. Either step through the installation sequence to catch all of 
your preferred settings, or open up the MSI and easily make your changes. 

Open a recent transform File (.mst) Customizations such as removing or relocating shortcuts, changing registry 

settings, adding files, pre-configuring ODBC databases, or creating a Ls 
So isting t f response file are all easily made through a clean interface that removes most 
pen an existing Gransrorm of the complexity of working with a typical setup. Using Tuner, you can easily 

Open an existing transform file (.mst) and quickly customize Windows Installer packages to meet your 

organization's needs, including limiting the features installed, adding custom 
files to the installation, and setting property values. You can also make 
@ installshield on the Web multiple customizations from the same base setup, drastically reducing the 
time to deployment. The result is an easy and intuitive way to ensure an 
installation is really your installation. 


x| 
a MSI Validation A Transform Validation A Packaging A Output 7 


Ready | NUM 


mm) Open a recent transform 


Explore InstallShield's Internet resources 
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Create a New Transform View 


This view is displayed when you click Create a new transform or select File » New on the InstallShield Today View. 


InstallShield Tuner DER) 


|| File Edit Yiew Go Project Tools Help 


jaeu@|DO|t++>|Zart|eGor,!\ee@ 
A InstallShield Today 


Base Windows Installer Package 
Select an MSI file. 


ey Welcome 
Welcome to InstallShield Tuner 


Provide a list of additional transforms to be applied. 


a Create a new transform 
Create a new transform file (.mst) 


So Open a recent transform 


Open a recent transform File (.mst) 


CS Open an existing transform Windows Installer Transforms 


Open an existing transform file (mst) edd Rtas ants name and location [or accept the default), and click Create to create a new 


@ Installshield onthe Web | C:\AdminStudio Shared\PackageForT he\Web 41.mst Browse 
Explore InstallShield's Internet resources 


Response Transform 


Command line properties (separated by ';') that will be passed to the Windows Installer package 
while creating a response transform 


| 


$i 


This view contains the following fields: 


Base Windows Installer Package Area 


Field Description 


Select an MSI file Enter the name and location of the Windows Installer package that you are customizing, or 
click Browse to locate it. 
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Field 


Description 


Provide a list of 
additional transforms to 
be applied 


If there are transforms already associated with the Windows Installer package, (for example, 
previous customizations or transforms containing language-specific information), click the New 
locate the transform. 


If multiple transforms are associated with this package, use the Move Up [A and Move Down 
[el buttons to specify the order in which the transforms are applied. 


ra N 

A- 

S Á 
When using multiple transforms, keep in mind that the order in which they are applied is 
critical. For example, if you create a transform for a Windows Installer package that creates a 
new value for a property, and then create a second transform that changes the value created in 
the first transform, everything works correctly. However, if you apply the second transform first, 


that transform is attempting to modify the property's value, instead of creating it. That will result 
in an error. 


One simple example of where this may be a problem is with the default company name. If the 
value is not set by default, and you set it in using the first transform, a new value for the 
property is created. If you create a second transform that modifies the combined original 
package and first transform, and the second transform changes the default company name, it is 
only changing the property. However, if you try to apply the second transform without the first 
one, Windows Installer interprets this as trying to change a null value to another value, which 
will result in an error. 


Windows Installer Transforms Area 


Field 


Description 


Provide a new project 
name and location (or 
accept the default) and 
click Create to create a 
new Customization project 


Provide a new project name and location. By default, the transform will be created in the 
same directory as the Windows Installer package, and named the same as the base 
package with an .mst extension. 


If you want to change the name and/or location of the transform, click Browse to open the 
Save Customization File dialog. Navigate to the directory in which you want to store the 
transform file you are creating. Provide the name of the transform with an .mst extension 
(for example, MyTransform.mst) and click Save. The dialog closes and the path and file 
name appear in the edit field. 


Response Transform 


If you want fo create a Response Transform, select this checkbox. 


If creating a Response Transform, step through the installation, making changes as 
necessary. When you reach the end of the installation sequence and click Install, the 
installation will exit and the Tuner interface will open your transform, which contains all of 
the changes you made during the simulated installation. 
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Field 


Description 


Command line properties 


If you are using a response transform, you can specify additional command-line properties 
(in property name/value pairs separated by semicolons) to pass to the response transform. 
These must be PUBLIC properties, and only control how the dialogs are displayed during 
creation of the response transform. They are not persisted outside of the UI sequence 
during creation. For example, you can pass the property/value pair 
ARPHELPTELEPHONE= 1-111-111-1111 to set the value of the Help Telephone field of 


Add/Remove Programs. 


You might pass a property/value pair during response transform creation to display alll 
dialogs during an installation that may not be displayed based on your system 
configuration (for example, to show Windows 9x-only dialogs on a Windows NT 
platform). You can then make appropriate responses and have them included in your 


transform. 


You can access information about the original MSI file and associated transforms by selecting Properties from the File 


menu. 


Open a Recent Transform View 


This view, a list containing your most recently accessed transforms, is displayed when you click on Open a recent 
transform. Select a transform and click Open to open it, or select Properties from the context menu to view 
information about it (including details about the base MSI package and associated transforms). 


InstallShield Tuner 


| File Edit View Go Project Tools Help 


Eak) 


joSnepn|t +e» mrs toL! oS 


A InstallShield Today 


Åt Welcome 
Welcome to InstallShield Tuner 


r] Create a new transform 
Create a new transform file (.mst) 


B Open a recent transform 


Open a recent transform File (.mst) 


B Open an existing transform 
Open an existing transform file (.mst) 


@ InstallShield on the Web 
Explore InstallShield's Internet resources 


Select a customization project from the most recently used list and click Open. 


Project MSI Location 


A) PackageForTheweb 4.mst 


| &) Orcat.mst C:\AdminStudio Shared\Orca.msi 


z 


C:\AdminStudio Shared\PackageF or... 


Project Location 
C:\AdminStudio Shared’, 
C:\AdminStudio Shared’, 


© Reload the last project saved when restarting InstallShield Tuner 
O Make this my default InstallShield Today Screen 
© Make Welcome my default InstallShield Today Screen 
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You can also select one of the options at the bottom of the view to determine the view that is opened when you start 
up Tuner: 


m load the last accessed transform when opening Tuner, 
m make this recent list the default InstallShield Today screen, or 
m make the Welcome screen the default InstallShield Today screen 


Open an Existing Transform View 


This view is displayed when you click on Open an existing transform or select File » Open. On this view, you can 
specify the name and location of the base Windows Installer package, any associated transforms, and the name and 
location of the transform file. 


Generally, you will only use this option when opening existing transforms that were created by a product other than 
Tuner, or created by someone other than yourself. Transforms you create using Tuner are mote easily accessed 
through using the Open a recent transform selection. 


InstallShield Tuner 


| File Edit View Go Project Tools Help 


|aena|DO|t+e+>|\Far|Oo.! |os 
A InstallShield Today 


Base Windows Installer Package 
Select an MSI file. 


wel 
wh Welcome C:\AdminStudio Shared\PackageForTheweb 4. msi 
Welcome to InstallShield Tuner —— ——— 


Provide a list of additional transforms to be applied. 


T Create a new transform 
Create a new transform file (.mst) 


So Open a recent transform 


Open a recent transform file (.mst) 


i) Open an existing transform Windows Installer Transforms 


Open an existing transform File (.mst) Select an MST file. 


@ installshield onthe Web C:\AdminStudio Shared\PackageForT heWeb 4.mst 


Explore InstallShield's Internet resources 


x| MSI Validation A Transform Validation A, Packaging A, Output 
- va L 


Ready 
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InstallShield on the Web Page 


This page links to Web-based information provided by InstallShield. The InstallShield Web site contains the latest 
product updates, technical support information, and InstallShield Tuner news. 


InstallShield Tuner DER) 


|| File Edit Yiew Go Project Tools Help 


joena|DO|t++>|zax|eo.!\os 
A InstallShield Today 


Services 
Åt Welcome 


Welcome to InstallShield Tuner InstallShield offers a wide range of award-winning services to customers, including the 
following: 


a Create a new transform 


Create a new transform file (.mst) SUPHOL sarees 


Knowledge Base—Search all available documentation to get answers to your 
O Open a recent transform questions fast, 
Open a recent transform file (.mst) Resource Center—See all the product documentation, sample projects, and 
developer resources available. 
© Open an existing transform Community—Interact with other InstallShield users and gain insight from 
Open an existing transform file (.mst) professionals in the field. 


Technical Support—Place a support request or see the support options available. 
@ InstallShield on the Web 


Explore InstallShield's Internet resources Consulting Services 


InstallShield Consulting is staffed with experts in installation development, 
Web deployment, demonstration development, and enterprise distribution 
ready to provide solutions for sophisticated software distribution challenges. 


Training Services 


InstallShield Training offers software professionals expert instruction in the 
use of InstallShield products. After attending an InstallShield course, 
students return to work with an understanding of the advanced features of 
their product and how to create solutions for complex software distribution 
and deployment requirements. Custom educational programs are also 


available, 
v 


aif MSI Validation A Transform Validation A Packaging A Output 7 
x 


Test the active project | NUM 
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Help View 


The Help view provides you instant access to this online help library. You can also access Microsoft's comprehensive 
Windows Installer reference library. 


E? InstallShield AdminStudio Help Library ME) 
Fie Edit Yiew Go Help 


d A e > @ & & 


Hide Locate Back Forward Home Print Options 


Contents | Index || Search | Favorites | Hble tibrarnraory ss InstallSh ° 


E È Using the AdminStudio IDE A 
E @ AdminStudio Security Pa 
@ $ Repackaging Legacy Setups Insta lis h le Id Tod ay 
@ $ Configuring Exclusions Tuner 

© $ Authoring and Enhancing MS 


© u Customizing Packages The InstallShield Today view allows you to create a new transform project or open 
o e Working with Transforms an existing one. This view also provides you with quick access to information about 


m È Validation _ Tuner. Select one of the following links for more information: 
© Setup Organization 


$ Configuring Package Cor 
e Working with Dialogs 4 
©@ Configuring Additional Se 
$ Changing Add/Remove F 
© Customizing Setup Prope 
e Preparing Packages for C 
e Directly Editing Packages 


Welcome 
General information about Tuner. 


Create a New Transform File 


Fs) + User Interface Refere Create a new customization, either starting with a blank transform, or by 
a Qj Views = using a Response Transform based on selections from a custom 
2 @ hield Tod installation, 
Help View 
E @ Package Vaiidati Open a Recent Transform File 
E è Organization Select a transform previously created with Tuner. 
© $ System Configure 
@ $ Application Conti 
@ $ Package Prepare 
E @ Additional Tools ¥ 


Open an Existing Transform File 
Select a transform created with a tool other than Tuner. You need to 
provide additional information, such as the base Windows Installer 


uit | 
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Package Validation 


Package Validation View 


The first recommended step in creating a transform is to perform validation on the base Windows Installer package. 
This helps you identify potential problems that you may or may not want to correct using Tuner. 


PackageForTheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 
| File Edit Yiew Go Project Tools Help 
joenes Dmt +e» Bax oon: os 


fe Package Validation 


liShield Tod. S . a 
oe Package Validation 


eo 

EA Prevalidation Prevalidate your existing Windows Installer package before customizing it. 
3- Organization 

Product Properties 

a Features 


B- System Configuration = Prevalidation . l , 
P Files and Folders pit Enter your product name, version, company name, and other information. 


g Also, select which languages your setup supports, 
Registry 


J Shortcuts 

INI Files 

Sa NT Services 

29 ODBC Resources 
B- Application Configuration 

a Server Locations 

[E] Setup Properties 

É} Dialogs 

B Add/Remove Programs 
(=) Package Preparation 


Postyalidation 
# Package 
B-E Additional Tools 
E] Direct Editor 


Package validation is performed in the Prevalidation view. To continue, click Prevalidation under Package Validation 
in the checklist. 
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Prevalidation View 


The Prevalidation view provides you a way to ensure the base Windows Installer package for your transform is valid. 
If it fails the validation test, then unexpected (and unwanted) results can occur during installation. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner DEAR) 


| Eile Edit View Go Project Tools Help 


jae@ua@|DD|t+er|Baxr|eo.!\ee 


Prevalidation #2 


5- Package Validation 
Prevalidation Installer Package: C^ AdminStudio Shared\AcroPro.msi 
S- Organization 
Product Properties 
CD) Features 


S-E System Configuration Evaluation File: Full MSI Validation Suite Browse 
Files and Folders 
, ICEs to Run: all Start 
Registry 


Shortcuts 
a INI Files CI Show "INFO" messages Show "WARNING" messages Show "ERROR" messages 


NT Services 
ODBC Resources 
5- Application Configuration 


4 Server Locations 
[E] Setup Properties 


el Dialogs To configure validation, first select the evaluation (.cub) file you want to validate 


te) Add/Remove Programs against, or click Browse to locate it, For best results, use the full logo-compliance 
5-63 Package Preparation evaluation files. Although you can enter individual Internal Consistency Evaluators (ICEs) to validate 
Postvalidation (separated by semicolons), it is best to evaluate all of them (All). 
R Package 
S- Additional Tools You can select the level of information you want to display in the Output window by checking the Info, 
iza) Direct Editor Warning, or Error check boxes. If the output has any error messages, it fails validation. 


¥alidation 


Once you begin validation (either by clicking the MSI Validation or Transform Postyalidation toolbar 
buttons), the results are displayed in the Output window, 


To begin the prevalidation process, select the evaluation file that you want to use for package validation (or click 
Browse to locate it), and click Start. By default, the file is evaluated using the full logo-compliant validation file, and all 
internal consistency evaluators (ICEs) are checked. If you just want to test specific ICEs, after you select the 
evaluation file, specify the ICE names, and separate them by semicolons if there is more than one. 


You can toggle the information level of the displayed results by checking the Show Info Messages, Show Error 
Messages, and Show Warning Messages check boxes. If any errors are present, the Windows Installer Package is 
invalid. Warning messages highlight potential problems, but will not cause validation to fail. Informational messages 
display ongoing information during the validation process. 
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Viewing the Prevalidation Results 


As each ICE is run, Errors, Warnings, and Info messages are generated, and are listed in the Output tab at the bottom 
of the interface. 


)|Validation started at 8/12/2003 1:07:57 PM... 
zi Original Msi File - C:\AdminStudio Shared\AcroPro.msi 


ERROR Invalid Filename; Table: File, Column: FileName, Key(s): esdupdate. dll 
WARNING Component: Distiller_Win_NT_System_files is a non-permanent system component 
WARNING Component: Distiller_Win9X_System_Ffiles is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_\W9x%_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9%_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9xX is a non-permanent system component 
WARNING Component: AdobePS W9X English Sys is a non-permanent system component 

MT) 


Upon completion of the Prevalidation, the Validation tab is automatically selected, and all of the Errors, Warnings, 
and Info messages that were generated are listed in table format. Each table row lists an icon to indicate whether it is 
an Error ©, Warning A or Informational message 4, the name of the ICE that generated it, and a brief description 
of what caused it to occur. 


xl] Ice Type Description A| 
z y= : : = 
ERROR Invalid Filename; Table: File, Column: FileName, Key(s); esdupdate.dll 

WARNING Component: Distiller_Win_NT_System_Ffiles is a non-permanent system component 
WARNING Component: Distiller_Win9X_System_Files is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X is a non-permanent system component ad 
ii l >| 
Validation Á Packaging / 
Ready | NUM 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. 


Direct Editor sa |] 


E Tables Conditic ^ | 
E _Validation Eler Bin_EXE | {DD4379F6 67-| ELEMENTS 0 mi 
E ActionText | Elements_Bin_Update {26EB60EE-5857-4145-t ELEMENTS 

AdminExecuteSequer Elements_Help_Englis {49B39488-7C40-4E14- HELP_ENU 

AdminUISequence Elements_MFC42 {6E2D8031-BA14-4482-1 SystemFolder 24 versioni 

E] âdvtExecuteSequent E] (676ED632-3CD7-4BAA-| INSTALLDIR o (1ct(Pro: 

AdvtUISequence Elements_UnicowDll | {47523907-B94D-4C69- ELEMENTS (Version¢ 

Appld ebook_ActiveX_GBDe {8ED34EF?7-70FB-4057-) ACTIVEX 

E] AppSearch eBook_Exchange_EDE {35044EDD-DO70-484F- ACROBAT 

AppsInUse Plugins_eBook {56454F03-FC42-4600-, PLUG_INS 

E BBContral eBook_Exchange_EDE {77ED68FF-1873-47B8-° ACROBAT 0 

E Billboard Plugins_PreFlight_Utili {2676139B-729C-4EFD-, PLUGINS_PREFLIGH 0 Product 

Binary Plugins_PreFlight {7C947044-DA38-434D- PLUGINS_PREFLIGH’ 0 Product 

BindImage PDFM: : {7D445966-3545-42EF-£| PDFMAKER_COMMO|0 

] CCPSearch PDFMakerx_Tlb {F78814E4-CAF5-4983- PDFMAKER_COMMO 0 

CheckBox PDFMaker_TTFont {F5EC2A4B-114F-4469-, FontsFolder 

Class Scan_Windows Files {4EC18029-40C8-4694- WindowsFolder (Version¢ 

E ComboBox Resources English § {B4E6E529-0648-48D5- RESOURCE 


CarmoanDaceweeDEh J272F2AFNOCFA-dREA. EORIT DEM 


<i i i% am] 
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This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows 
Installer package and store them in your transform. For more information, see Direct Editor. 


If no errors appear in the results (providing you are displaying errors), then the package is valid against the specific 
ICEs you specified, or against the entire evaluation file (if no ICEs were selected). 


Organization 


Organization View 


The Organization view allows you to modify two main parts of the installation that your end users will see: the default 
path and default company name, and the actual features that can, will, or will not be installed. 


PackageFor TheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 
| File Edit View Go Project Tools Help 
joenes nmt +e» mas Don: os 


fe, Organization 


InstallShield Toda . . 
PE ” Organization 
B- Package Validation 
EA Prevalidation Organize your setup to make development easier, and to allow your users to 
Sim] Organization | customize which parts of your application they install. 
Product Properties 
H Features 
4 System Configuration 


; Product Properties 
9 Files and Folders Specify the default directory for installation, the default organization name, 


Registry and the default destination variable. 
F Shortcuts 


INI Files 

Hy NT Services Features 

29 ODBC Resources Configure the description, initial state, and visibility foreach feature.in the 
= Application Configuration Windows Installer package. 

g Server Locations 

[E] Setup Properties 

É Dialogs 

Ea) Add/Remove Programs 
5- Package Preparation 


Postvalidation 
Package 


5- Additional Tools 
E] Direct Editor 


aif MSI Validation A Transform Validation A Packaging A Output 7 
x 


Ready NUM 


InstallShield Software Corporation © 2004 498 


AdminStudio 5.5 User Guide 9 Customizing Packages 


Each view available under Organization is described below: 


View Description 


Product Properties When a user runs a custom installation of a Windows Installer package, the Custom Setup 
dialog provides a default installation path and a default organization name. The Product 
Properties view provides a mechanism for changing these defaults. 


Features Features are the building blocks of the installation. They represent distinct pieces of functionality 
to end users, such as program files, help files, or clip art. You can modify which features and 
subfeatures are installed, and how they are installed, in the Features view. 


Product Properties View 


This view gives you a way to specify the default path on the user's computer into which the application will be 
installed. You can also specify the default organization name (i.e., your company's name). 


PackageForTheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 


H Product Properties 


y InstallShield Today Product Properties 
@) Help Property Yalue 
4 Package Validation Default Destination Variable INSTALLDIR 
E Prevalidation Default Destination Path ProgramFilesFolder\InstallShield\PackageForTheWeb 4 
S- Organization Company Name 
Features 
=} © System Configuration 
D Files and Folders 
g Registry 
FJ Shortcuts 


INI Files This is the variable in which the Default Destination Path is stored. If you change 


NT Services its value, it may cause adverse affects on the installation. For full information, 
ODBC Resources please refer to the Default Destination and Organization online help topic. 
=) Application Configuration 


g Server Locations : ee . . enh 
[E] Setup Properties Reset | This button resets the Default Destination behavior to its original (base MSI) 


©) Dialogs value, 
a) Add/Remove Programs 
i) © Package Preparation 
Postvalidation 
# Package 
=} Additional Tools 
Direct Editor 


Default Destination ¥ariable 


The following properties are associated with this view: 


Default Destination Variable 


This is the name of the variable that stores the Default Destination Path. If you change this variable, you could create 
errors during postvalidation. Click on the variable's value to display a combo box that allows you to select a variable. 


Generally, the variable used will be INSTALLDIR or INSTALLLOCATION (both author-created variables). 
However, another variable can appear as the value: TARGETDIR (a Windows Installer variable). If TARGETDIR is 
suggested, it is strongly recommended you contact the vendor who created the original MSI and ask what was used 
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for the Default Destination Variable. While it is possible that it was TARGETDIR, it is also possible another variable 
was used and Tuner cannot identify this non-standard variable. 


If the incorrect variable is set here, and/or if the Default Destination Path is changed, the installation may not 
function properly. If that happens, you can reset the information in this view by clicking on the Reset button when 
the Default Destination Variable is selected. 


More information can be found in the MSI Help under the Help menu. 


Default Destination Path 


This location, stored within the Default Destination Variable, is the path where the application will be installed on the 
target machine, unless overridden during installation from the Custom Setup dialog. Click on the path's value to 
display a combo box of possible paths, or edit the path in the value field. It can be a hard-coded path, or it can be a 
Windows Installer folder property . Further levels can be separated with a backslash—for example, 

Program FilesFolder\MyApp\ Bin. 


To comply with Windows logo requirements, the application must default to a subfolder of ProgramFilesFolder, 
which can vary depending on the system's locale and user settings. If ProgramFi 1esFolder\ProductName, is 
specified as the default value for the Destination Folder property, then this product's files will always be installed to 
the logo-compliant location. 


Company Name 


This is the name the installation suggests for your organization during setup. If it is not set, the installer will 
automatically set it during installation using values from the registry. Once the value has been entered for the name of 
the organization, the COMPANYNAME property can be seen in the Setup Properties view. 
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Features View 


This view allows you to change Feature properties to best suit your situation. 


PackageForTheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner DER) 
| Eile Edit Yiew Go Project Tools Help 
|o ene Dmt +e> | Bas OSL!\eo@ 


# Features 


$Å InstallShield Today W Features PackageForTheWeb4NewFeature 
©) Help ka] PackageForTheweb4NewFeature Description PackageForTheweb4NewFeature 
S- Package Validation ©) NewFeaturet Visible Visible and Collapsed 
Prevalidation Initial State The feature is installed on the local drive. 
4 Organization 
Product Properties 
5] Features 
4 System Configuration 
Files and Folders Description 
Registry 
3 Shortcuts This property contains a description that will be 
~ INI Files displayed when a feature is clicked in the Custom 


NT Services Setup dialog during installation, 
ODBC Resources 


=] DB Application Configuration 
a Server Locations 
[E] Setup Properties 
É Dialogs 
ay Add/Remove Programs 
4 Package Preparation 


Postvalidation 
Package 


©) Additional Tools 
Direct Editor 


Features are the building blocks of an installation from an end user's perspective. They represent a specific capability 
of the product, such as the help files or a part of a product suite that can be installed or uninstalled based on the end 
user's selections. Features can be composed of subfeatures, which in turn can be composed of further subfeatures. 
Depending on the visibility of the "parent" feature, end users can select which portions of a feature to install in the 
Custom Setup dialog. 


Each feature and subfeature has properties that can be modified within Tuner. These include a description of each 
feature (as it appears in the Custom Setup dialog), its visibility, and its initial state . Tuner allows you to change these 
feature properties to best suit your situation. For example, you may want to prevent a specific application within a 
suite from being installed in a particular transform file. By changing its initial state and visibility, you can prevent your 
end user from ever seeing this feature during installation. 
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The Features View contains the following fields: 


Field Description 

Description This description will be displayed when this feature is clicked in the Custom Setup dialog during 
installation. 

Visible Specifies how the feature will be presented to the end user during installation in the Custom Setup 


dialog. The following options are available: 


a Visible and Collapsed -—This feature will be displayed in the Custom Setup dialog with its 
subfeatures collapsed by default. 


a Visible and Expanded —This feature will be displayed in the Custom Setup dialog with its 
subfeatures expanded by default. 


= Not Visible—This feature will not be displayed to the end user in the Custom Setup dialog. 
Although an end user obviously cannot select or deselect an invisible feature, this property does not 
affect whether a feature is installed. In other words, a feature is not automatically installed if it is 


invisible; it just cannot be deselected if it would otherwise be installed, or selected if it should not be 
installed. 


Initial State Provide the initial state for the feature. The end user can override this from the Custom Setup dialog. 
Your options are: 


a The feature is not installed —By default, the feature will not be installed during setup. 


= The feature is installed on the local drive —By default, the feature will be installed on the 
local drive during setup. 

a The feature is run from source, CD, or network — By default, the feature will be run from 
the source, whether it be from the installation CD or from the network. 


= The feature is advertised—By default, the feature will be advertised, but not installed. 
Essentially, this is an on-demand option; a shortcut will be created during setup, and if the shortcut 
is clicked, the feature will then be installed from the source. This ensures features that may be 
unnecessary are not installed until they are needed, if ever. 
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System Configuration 


System Configuration View 


The System Configuration view provides you with the ability to add additional files to a Windows Installer installation 
package, as well as add, remove, or modify shortcuts and registry information. Ultimately, this allows you to customize 


the installation to your needs, such as including company-specific templates in the correct folder during installation. 


PackageForTheWeb 4.mst (PackageForTheWeb 4.msi) - InstallShield Tuner 


ile Edit View Go Project Tools Help 


DER 


| 
joens Dmt +e» mas oon: os 


@@% InstallShield Today 
@) Help 
B- Package Validation 
EA Prevalidation 
B- Organization 
Product Properties 
B Features 


i 
Files and Folders 
a Registry 
A Shortcuts 
“$ INI Files 
Hy NT Services 
9 ODBC Resources 
& B Application Configuration 
d Server Locations 
[E] Setup Properties 
É Dialogs 
i B Add/Remove Programs 
=) Package Preparation 


Postvalidation 
Package 


B- Additional Tools 
Direct Editor 


a System Configuration 


System Configuration 


s Configure the target system with settings required by your application, 


Files and Folders 
Add files to your setup project. You can organize these files into folders on the target system. 


$> Registry 
Create registry keys and values that will be created on the target system. Drag and drop 
registry keys, or import a reg file, 


(>=) Shortcuts 
-ÆJ Create shortcuts on the target system's Start Menu or Desktop. 


INI Files 
[$ Make changes to system ini files, or to custom ini files that are part of your application, 


NT Services 
Configure NT services included in the base Windows Installer package. 


=E] ODBC Resources 
(ly Configure the ODBC resources on the target system. You can configure ODBC drivers, 
= translators, and data source names. 


Packaging A, Output 


¥ 


xl MSI Validation A, Transform Validation 


Ready 
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Files and Folders View 


The Files and Folders View consists of four panes, representing the Source and Destination views. 


Paint Shop Pro 7 Anniversary Edition.mst (Paint Shop Pro 7 Anniversary Edition.msi) - InstallShie... DAR 


|| Bile Edit view Go Project Tools Help 


jaeHa@|Dn|t+e>|Baxrt|eGo.!\e@ 
B Files and Folders 


Êt InstallShield Today Source computer's directory tree Source computer's files 
@) Help 
4 Package validation Size | Type 
7 °a freveldston W Š My Computer 
oe art & My Network Places 
B- Organization Ht 
Product Properties US) My Documents 
D Features 
4) System Configuration 
QD Files and Folders 
a Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources Destination computer's Folders Destination computer's files 


5- Application Configuration Destination Computer _ Name Size 
E Server Locations =) ProgramFilesFolder p 
[E] Setup Properties S- Jasc Software Inc 
my Dialogs Paint Shop Pro 7 
wg} Add/Remove Programs (©) SystemFolder 

4} Package Preparation (©) WindowsFolder 

Postvalidation 

# Package 

4 Additional Tools 
Direct Editor 


readme, doc 35,0 KB 
RefColor.dat 17.4 KB 
pspud. Flt 251 bytes 
Register.exe 138 KB 
tips.txt 15.6 KB 
PCache02,JDB O bytes 
PCache01.JDB 0 bytes 


hanl? Fl- n nvo 
ii 


aif MSI Validation A Transform Validation A Packaging A Output 7 
= 


Ready | NUM 


* [CCCOCOCOCO 


Source Computer View 
The Source view, located at the top, displays the folder and file structure on the user's computer. 
Destination Computer View 


The Destination computer's folders pane represents the folders on the target machine for the installation. The folders 
initially displayed for the target machine are ones used commonly in installations. 


The Destination computer's files pane displays the files that are part of the installation. Initially, only files contained in 
the base Windows Installer package are displayed. When you add files to the package (into the transform), these also 
appear in this pane. 


Tuner cannot display files contained within compressed files. 


A key file is a file that the Windows Installer uses to detect a component's presence. If the key file is in its proper 
location, the installer assumes that the entire component is installed correctly. Each component can have a key file, 
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represented in the Files and Folders View by a key icon &. The key files were set by the setup author, and cannot be 
modified using Tuner. 


Destination Computer View Tasks 
The following tasks are performed in the Destination Computer View: 


E Defining a New Folder—To define a new folder, select either the Destination Computer or a predefined 
folder from the Destination Computer's Folders pane and select Add from the context menu. 


Destination computer's folders B 


Destination Compi 

B- ProgramFilesFt 
B- InstallShie 

a- Packag 

£ La 

© SystemFolder 


Show Folder 


Properties 


E Adding Files to an Installation—To add files to an installation, simply locate them within the Source view, 
and either drag and drop them to the appropriate destination folder, or use the copy and paste commands. 


= Removing Folders or Files—To remove folders and files you have already added to the installation, select the 
file or folder from the Destination view and select Delete from the context menu. Predefined folders are required 
for installation and cannot be removed. If you add files to an installation, they are always installed. 


= Removing Files from the Base Windows Installer Packeage—Files from the base Windows Installer 
package can be removed during installation, except for key files. To remove a non-key file from the MSI, right- 
click on the file and select Remove from the context menu. The file is marked with an icon indicating it is not to 
be installed during installation. 


Destination computer's files 


r Name 
A) DemoPlayer.msi 
r Pftwwiz, chw 
Icon indicates — Pal readme.htm 
that file will not # pftwwiz.exe 


be installed. 
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Registry View 


Similar to the Files and Folders View, the Registry view consists of four panes representing the Source and 
Destination views. 


PackageForTheWeb 4.mst (PackageFor TheWeb 4.msi) - InstallShield Tuner 


|| Ele Edit view Go Project Tools Help 
|2 Sne nitte» mar Dsn: o 
& Registry 


9% InstallShield Today Source Computer Registry View Source Computer Registry Data 
©) Help 7 
S- Package Validation . tt Computer Name Data 
ae =- HKEY_CLASSES_ROOT 
EA] Prevalidation — | 22) (Defaut) (value not set) 
B- Organization GG HKEY_CURRENT_USER ab) activeBorder 212 208 200 
= 
= ca 
Product Properties 7 = Baa ab) ActiveTitle 084227 
(=j Pe aliia uration G © Control Panel Eo e ia 
yste g E- Accessibility Background 078152 
L) Files and Folders -© Appearance ab)ButtondlternateFace 181 181 181 


a Registry © Colors ab) ButtonDkShadow 113111 100 


E Shortcuts Ga Current: ab) ButtonFace 236 233 216 


INI Files 
NT Services o a 
ODBC Resources Destination Computer Registry View Destination Computer Registry Data 
(ES) HKEY_CLASSES_ROOT m 
i = = Default 
[E] Setup Properties (ÆJ HKEY_CURRENT USER ai ) 
£ Dialogs (=) HKEY_LOCAL_MACHINE 


ia wt} Add/Remove Programs C HKEY_USER_SELECTABLE 
B- Package Preparation © HKEY USERS 


Postvalidation 
Package 


= Additional Tools 
Direct Editor 


< 


(value not set) 


MSI Validation A Transform Validation 


Source Computer View 


The Source view, located at the top, displays the registry entries on the administrator's computer. 


Destination Computer View 


The Destination view represents the registry entries on the target machine for the installation. By default, the 
Destination view contains the following read-only registry hives: HKEY_CLASSES_ROOT, 
HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_USERS, and HKEY_USER_SELECTABLE. 


You can use the Registry view to: 


E Create registry keys and values. You can do this using the same procedure you use to create registry keys 
and values in the Windows Registry Editor, or you can copy or drag and drop existing keys and values from the 
Soutce view to the Destination view. 


= Import an existing REG file using the Import REG File Wizard. 


m Modify or delete registry keys that are part of the base installation. If you add new registry keys, 
they will always be installed. 
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Setting Registry Key Options 


You must be cautious when creating new registry keys so adverse results do not occur. You must specify whether the 
key is to be created at install, removed at uninstall, or both. These mutually exclusive options are available by right- 
clicking on a key. 


Destination Computer Registry view 


My Computer 
S- HKEY_CLASSES_ROOT 
E -silink 
- © csip New (Insert) > 
B- | 
ag] Copy (Ctrl+C) 
{ Paste (Ctrl) 
E a Delete (Del) 
E] Pa Rename (F2) 
iz = | Create Key At Install 
a- | 
a @ CSTI Delete Key At UnInstall 
gy CsT Both Create And Delete 
H-E CST! Import REG File... 
Option Description 
Create Key at Install Creates the new registry key during installation if the key does not exist on the target machine. 


Delete Key at Uninstall Deletes the registry key during uninstallation, regardless of whether the key existed prior to the 
MSI's installation. This means that the key, and all its contents and sub-keys, will be removed 
regardless of whether other software information that is unrelated to this MSI exists. This can 
have a severe impact on other programs; only select this option if you are sure that the only 
software affected is the base MSI. 


Both Create and Delete Both of the above scenarios will occur. 
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Shortcuts 


Shortcuts View 


The Shortcuts view offers an integrated, visual method for adding shortcuts and program folders to the installation. 
Existing shortcuts can also be modified or removed. For information on how to use the Shortcuts view to create, edit, 
or remove shortcuts, refer to one of the following topics: 


= Shortcut Properties—Explains the Properties that you set when creating a shortcut. 


E Shortcut Locations—Fxplains how to specify the location of a shortcut, either in a predefined folder or a folder 
that you create. 


E Shortcut Targets— Explains how to specify the path to the shortcut's target application, batch file, folder, or 
feature. 


AcroPro.mst (AcroPro.msi) - InstallShield Tuner 
“ile Edit View Go Project Tools Help 


Dense ntse» Bax DIL! oS 


~ 


Shortcuts @& 


S-E Package Validation W Destination Computer Adobe Acrobat 6.0 Professional 
Prevalidation B-E DesktopFolder SC_Acrobat_DT.exe 
B-E Organization Acrobat Elements 6.0 Description 
Product Properties E Adobe Acrobat 6.0 Profession | Arguments 
€ Features E Adobe Acrobat 6.0 Standard | Target Type File From file system 
B-E System Configuration B-E ProgramMenuFolder Target [INSTALLDIR JAcrobat\Acrobat.exe 
Files and Folders Acrobat Distiller 6.0 Run Normal Window 
Registry Adobe Acrobat 6.0 Profession | Working Directory 
Shortcuts E Adobe Acrobat 6.0 Standard |Hot Key 
INI Files S- PrintMe Internet Printing 
NT Services ©) Download Driver 
ODBC Resources E Learn More 
&)( Application Configuration B-E StartupFolder 
Server Locations Acrobat Assistant This property displays the name of the icon for 
E Setup Properties this shortcut. You can change it by clicking the 
E Dialogs Change Icon button. From the resulting dialog, you can 
A Add/Remove Programs browse to an EXE file or DLL, which will then display all 
=) Package Preparation contained icons. Select the appropriate icon and click OK, The 
# Postvalidation name of the icon will appear in the Icon value cell, and a 
Package picture of the icon will appear next to the Change Icon button. 
=) Additional Tools 
Direct Editor 


2 — 
Change Icon... Clear Icon 


Shortcuts created in the transform are denoted by ŽA and shortcuts from the base Windows Installer package are 


denoted by Æ. 
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Shortcut Properties 


When creating or editing a shortcut, you specify properties on the Shortcut Properties View. 


Orca1.mst (Orca.msi) - InstallShield Tuner DER) 


| File Edit View Go Project Tools Help 


joeus|DD|\t+e>|Bax|OSL!\e@ 
fx Shortcuts 


Åt InstallShield Today W Destination Computer 
@) Help = ca) ProgramMenuFolder Icon orca_icon.exe 
=) Package Validation E Orca Description This shortcut launches Orca, a MSI Table Editor. 
Prevalidation E © Orca Arguments 
5- Organization Fz] Orca Target Type Advertised shortcut 
Product Properties Target Orca 
2 Features Run 
& (m) System Configuration Working Directory 
Q Files and Folders Hot Key 
ay Registry 
OFA Shortcuts 
-$ INI Files 
A 


Sa NT Services : N 
H ODBC Resources This property displays the name of the icon for this Give Us Feedback 


5- Application Configuration shortcut, You can change it by clicking the Change Icon 
g Server Locations button. From the resulting dialog, you can browse to an EXE file or DLL, 
[E] Setup Properties which will then display all contained icons. Select the appropriate icon and 
É Dialogs click OK. The name of the icon will appear in the Icon value cell, and a 
gh Add/Remove Programs picture of the icon will appear next to the Change Icon button. 
=) Package Preparation 
Postvalidation 
# Package È 
5- Additional Tools 
PP Direct Editor 


aff MSI Validation A Transform Validation A Packaging A Output 7 
(Ey i 


Ready NUM 


Change Icon... | Clear Icon | 


The Shortcut Properties are described in the following table: 


Property Description 


Icon Displays the name of the icon for this shortcut. 


= To change the icon, click the Change Icon button. On the Change Icon dialog, click Browse 
to select an EXE file or DLL. All of the icons contained in that EXE or DLL file are displayed. Select 
the appropriate icon and click OK. On the Shortcut Properties view, the name of the icon now 
appears in the icon value cell and a picture of the icon appears next to the Change Icon button. 


= To remove the icon, click Clear Icon. 


Description A brief description of the shortcut. The text in this field will appear when users hover the mouse 
pointer over the shortcut in Windows 2000 or later. 


Arguments Any command-line arguments for the shortcut. 
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Property 


Description 


Target Type 


The destination folder, or a file from the MSI or transform. This property can be set to one of the 
following values: 


= File from MSI Package— Used if the shortcut is to a file that is part of the base Windows 
Installer package. 

= File from System— Used if the shortcut is to a file that already exists on the target system. It 
may also be from the transform file. 

= Destination Folder—Used if the shortcut points to a folder rather than a file. The folder can be 
on the target system, from the MSI package, or from the transform. 

= Advertised shortcut—Used if you want this to be a shortcut to an "advertised" feature. 
Advertised features are not installed immediately during the setup process. Instead, they are 
installed when requested. The shortcut makes it appear that the feature is already installed, 
although it is not installed until the end user requests it. 


Target 


Path and file name for this shortcut's target. There are many potential types of targets, including 
applications, files, folders, printers, and computers on a network. Instead of hard-coding a path, you 
can use a Windows Installer folder property in square brackets—for example, 
[INSTALLDIR]\MyApp.exe. You can also target Windows Installer features, which you can use for 
feature advertisement. 


To specify a feature as a shortcut target, enter the name of the feature in the Target field. You can 
determine the name of the feature by going to the MSI Table Editor and selecting the Feature table. 
The list of features you can target with your shortcut is listed in the Features column of the table. 


Run 


Specifies how the item is displayed when the shortcut is double-clicked. You can select from the 
following options: 

a Normal Window-— Launches the program in a normal sized window. 

a Maximized Window — Launches the program in full-screen view. 


a Minimized Window —Launches the program in a minimized window, visible only on the 
taskbar. 


Working Directory 


Default directory for the Save As and Open dialogs. If you are modifying an existing shortcut, or 
creating a new one, you can select a Windows Installer folder property from the list instead of hard- 
coding a path. Separate further levels with a backslash—for example, 
<ProgramFilesFolders>\MyApp \Bin. 


Hot Key 


The decimal value of the hot key combination for this shortcut. The Hot Key feature allows end users 
to launch a shortcut by pressing a combination of keys, rather than using the mouse. When you click 
in the Hot Key field to create or modify a shortcut, the Hot Key dialog appears. While the Hot Key 
dialog is open, press the desired hot key combination; those keystrokes are recorded. When you 
click OK on the Hot Key dialog box, Tuner automatically converts the keystrokes into a decimal value 
and enters that value in the Hot Key field. 


Microsoft recommends that you do not set this value, as it may conflict with existing hot key 
combinations on the target machine. 
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Shortcut Target 


There are four shortcut Target Types you can add to a transform: 


Target Type Description 

File from MSI Package Used if the shortcut's target is a file that is part of the base Windows Installer package. 

File from File System Used if the shortcut's target is a file already existing on the target system. 

Advertised Shortcut Used if you want this to be a shortcut to an "advertised" feature. Advertised features are not 


installed immediately during the setup process. Instead, they are installed when requested. 
The shortcut makes it appear that the feature is already installed, although it is not installed 
until the end user requests it. 


Destination Folder Used if the shortcut points to a folder rather than a file. 


The Target Type that is selected affects what you should enter in the Target property field: 


= File from MSI Package & File from File System—Under most circumstances, shortcut targets are 
applications or batch files. You simply provide the full path to the application or batch file in the Target property. 
However, after entering the target, if you leave the Shortcuts view and then return to it, you find that the target has 
changed. For example, you might have entered C:\Temp\MyFolder\mytarget.exe as the target, but it now reads 
[MyFolder]mytarget.exe. What has happened is InstallShield has replaced the path based on entries made to the 
Directory table. By stringing together the directories you just located in the Directory table, you can determine the 
path represented by [MyFolder] in the shortcut target. If you use the drop-down list in the Target property, you 
can determine the absolute values of these other directories in the same fashion. 


= Destination Folder—To point the shortcut to a folder rather than a file, select Destination Folder in the Target 
Type property, and then select a folder name from the Target property drop-down list. The Target list includes 
available folders on the target system, from the MSI package, and from the transform. 


= Advertised Shortcut—You can also target Windows Installer features, which you can use for feature 
advertisement. To specify a feature as a shortcut target, simply enter the feature name in the Target field. You can 
determine the name of the feature by going to the Direct Editor and selecting the Feature table. The list of features 
that you can target is listed in the Features column of the table. 
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Shortcut Locations 


When you first navigate to the Shortcuts view, you see a set of predefined folders with existing shortcuts (if the base 
MSI package had shortcuts defined). You can modify or remove these shortcuts according to your needs. 
W Destination Computer 


=] © ALLUSERSPROFILE 
E PackageForTheWeb 4 


If you need to create your own shortcut, you can place it in a new folder you define or in a predefined folder. 
Additional predefined folders that are not displayed can be accessed by right-clicking on the uppermost item in the 
Shortcuts explorer and selecting Show Folder. 


Show Folder a v ALLUSERSPROFILE 


AdminToolsFolder 
AppDataFolder 
CommonAppDataFolder 
CommonFiles64Folder 
DesktopFolder 
FavoritesFolder 

FontsFolder 
GlobalAssemblyCache 
ProgramFilesFolder 
LocalAppDataFolder 


& © ALLUSERSPRO 
E PackageFo New Folder (Ins) 


Under the Show Folder submenu is a list of the additional predefined folders supported in the Shortcuts view. Select 
the folder where you want your shortcut created to have it displayed in the Shortcuts explorer. The predefined 
shortcut destinations are described below. 


Alternately, you can create your own folder in which to place shortcuts by right-clicking either a folder or the top level 
Shortcuts item and selecting New Folder. To remove a folder that you have added, right-click on it and select Delete. 


The following predefined folders are available for shortcuts: 


Predefined Folder Name Description 


AppDataFolder The current user's Application Data folder. 
CommorfilesFolder The Common Files folder for the current user. 
DesktopFolder The user's desktop. Although placing a shortcut on the desktop makes it easily visible, it can 


also be distracting to users, so it should be used sparingly. 


FavoritesFolder he Favorites folder for the current user. 
FontsFolder References the target machine's Fonts folder. 
INSTALLDIR The installation's default destination folder. 
ProgramFilesFolder References the target machine's Program Files folder. 
ProgramMenuFolder The Program menu for the current user. 
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Predefined Folder Name Description 


SendToFolder The user's Send To folder, which is accessible when you right-click on files. Shortcuts are 
placed here so users can have quick access to the target program from many file types. 


StartMenuFolder The Start menu folder for the current user. 


StartupFolder The current user's Startup folder. Shortcuts placed here automatically launch their targets 
whenever Windows is started. 


SystemFolder The target machine's System folder. 

TempFolder References the target machine's Temp folder (usually C:\Temp). 
TemplateFolder The current user's Template folder. 

WindowsFolder The target machine's Windows folder. 


INI Files View 


Initialization (INI) files serve as a database in which you can store and retrieve information between uses of your 
application. Typically, INI Files contain key name-value pairs representing run-time options for applications. Some 


The INI Files view provides a graphical way for users to add, modify, or delete the contents of the IniFile Table. 


The INI Files view displays the contents of the IniFile table from the source Windows Installer package 3) and 
the transform #3, 


The view itself consists of three panes: the leftmost a tree of predefined folders from the Windows Installer 
package and user-defined folders from the transform. 


The top-right section displays the keys and values in the selected IniFile section. Windows Installer and transform 


values are distinguished by different icons in this pane. 


The lower-right pane provides information about the selected key. 
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InstallShield AdminStudio.mst (InstallShield AdminStudio.msi) - InstallShield Tuner 
|| File Edit View Go Project Tools Help 
|o ene |DD|t+e>|Bax~|\eoL! \o@ 
& INI Files 


$f} InstallShield Today Destination Computer QuickStart Guide 
@) Help S- ProgramFilesFolder 
5- Package validation S- InstallShield 4| åppHelpFile LINSTALLDIR JProgram\040 Add Line 
Prevalidation 4 Adminstudio A ADPArguments [INSTALLDIR JProgram\040 Add Line 
S- Organization SG 5.0 la.) AppDefault Demo32.exe Add Line 
Product Properties i} AdminStudia. ini A AppLocation [INSTALLDIRJProgram\040. Add Line 
©) Features ab] QuickStart Guide 
B- System Configuration = Common 
Files and Folders =) $ Developer ini AppLocation 
Registry ab) developer 
Shortcuts S- Repackager Keys have the following properties, which must be set in order 


INI Files 8 isqm. ini for your INI file change to occur: 
NT Services 


ODBC Resources 
=) Application Configuration Property Description 
4 Server Locations 


[E] Setup Properties Key The name of the key. This should be entered in the exact 


a resi p way it should appear in the target INI file. 
E emove Programs 


5- Package Preparation i , 
# Postvalidation The key's value, Windows Installer properties can be used 


Package in your keyword's value. To do this, surround the property 
= Additional Tools with square brackets—[INSTALLDIR], for example. 


im Direct Editor 


Action The action they key performs. Select this from the list in 


the property sheet. The available options allow you to add 
a line, add a tag, or create a line. 


Ej For a comprehensive list of Windows Installer properties, refer 
to the Property Reference topic in the MSI Help. 


x| n MSI Validation A Transform Validation A Packaging A Output 7 


Ready 


Editing INI Files in Tuner 


To edit an INI File in Tuner, simply expand the appropriate IniFile node in the tree. Then select the appropriate 
section, which appears in the upper right pane. You can then edit the keys and values appropriately. You can also 
insert new keys and values by right-clicking in the key and value pane and selecting Add. If you want to add a new 
section to an INI File, right-click on the INI File in the tree and select New Section. You can also delete an INI File, a 
section of an INI File, or a key by right-clicking the appropriate node or property sheet entry and selecting Remove. 
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ODBC Resources View 


Open Database Connectivity (ODBC) Resources are ones that involve interaction with databases. Tuner allows you to 
view existing ODBC Data Sources, ODBC Drivers, and ODBC Translators. 


Install_ODBC_Resources.mst (Install _ODBC_Resources.msi) - InstallShield Tuner 
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=) ODBC Data Sources 
# dBase Files 
Fi Excel Files 
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S FoxPro Files 
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EA My New DSN 1 
S my New DSN 2 
# Text Files 

H-E ODBC Drivers 

H- ODBC Translators 


ODBC Resources ¥iew 


Open Database Connectivity (ODBC) Resources are 


ones that involve interaction with databases, Tuner 

allows you to view existing ODBC Data Sources, ODBC Drivers, 
and ODBC Translators. The left pane of the ODBC Resources view 
contains a tree with the three root nodes: ODBC Data Sources, 
ODBC Drivers, and ODBC Translators. When any of these are 
expanded, individual Data Sources, Drivers, and Translators 
contained in the Windows Installer package are displayed, When 
selected, each of these individual nodes displays information in a 
property grid displayed in the upper right pane. 


j Only ODBC Data Source attributes are editable; 
ODBC Drivers and ODBC Translators are provided 
in read-only form. 


The left pane of the ODBC Resources view contains a tree with the three root nodes: ODBC Data Sources, ODBC 
Drivers, and ODBC Translators. When any of these are expanded, individual Data Sources, Drivers, and Translators 
contained in the Windows Installer package are displayed. When selected, each of these individual nodes displays 
information in a property grid displayed in the upper right pane. 


There are three different types of ODBC Resources available for viewing and/or modification through the ODBC 


Resoutces view: 


Resource Type 


Description 


ODBC Data Sources 


The source of the data (database type) and information on how to connect to that database. 
Common database types include Microsoft SQL Server, Microsoft Access, and Visual FoxPro. 
Connection information may include the name of the database, where the server that hosts it is 
located, and logon/password information. You can add new ODBC Data Sources from the 
ones existing on your computer, or delete ones you add or existing ones from the MSI. You can 
also add, edit, and delete ODBC Data Source attributes. If your machine does not have the 
ODBC Data Source that is needed by the package, you can type it into the ODBC Data Source 
dialog. 


ODBC Drivers 


These are libraries that implement functions involving ODBC. Each database type has its own 
ODBC driver. You can add only those Data Sources for which ODBC Drivers exist in the MSI 
package. You can add, edit, or delete new attributes for ODBC Drivers, and you can edit or 
delete all attributes except for File, Setup File, and Feature. 
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Resource Type Description 


ODBC Translators These translate one form of raw data into another form that can be used with a specific 
database type. For example, an ODBC translator may convert from one code package to 
another. You can only view the contents of an ODBC Translator and cannot add, delete or 


modify them. 


Only ODBC Data Source attributes are editable; ODBC Drivers and ODBC Translators are provided in read-only form. 


NT Services View 


The NT Services view provides a way to change parameters for NT Services included in the base Windows Installer 
package. 


Norton AntiVirus Corporate Edition3.mst (Norton AntiVirus Corporate Edition.msi) - InstallShield Tuner DER) 


| Eie Edit view Go Project Tools Help 


joeunusomt +e» maxs eono 


NT Services * 
B- Package validation Sy Services ServiceInstall0 i 


EE Prevalidation By Name DefWatch 
B- Organization Ry ServiceInstall1 Display Name 
Product Properties Service Type 
©) Features Interact with Desktop | No 
a (fem) System Configuration Start Type Operating System Loader 
9 Files and Folders Error Control Ignore Error 
Registry Overall Install Continue overall install, if service Fails to install 
Shortcuts Load Order Group 
INI Files Dependencies 
NT Services Start Name 
ODBC Resources Password 
H-E Application Configuration Arguments 
H-E Package Preparation Description 
H-E Additional Tools Feature NortonAntivirusCorporateEditionFeature 


NT services cannot be added to a setup using Tuner. You can only make modifications to services in the base Windows 
Installer package. 


The following properties can be modified: 


Property Description 


Name This property contains the name of the service to install. This property may have the same 
value as the Display Name, but is used by the installer in a different way. 
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Property 


Description 


Display Name 


The name of the service as it appears in user interfaces (such as the name used under the NT 
Services control panel). This string can be a maximum of 256 characters in length. It may be 
the same as the Name property. 


Service Type 


There are two service types available: 


m Service that runs in its own process 


= Service that shares a process with others 


Interact with Desktop 


Although uncommon, some services need to interact with the desktop to display message or 
dialog boxes for the user. If this service requires this functionality, this property's value is set to 
Yes. 


Start Type 


The value in this property dictates when the service is started. The possible values are: 


= Automatic—The service starts during system startup. 


a Manual—The service starts when the service control manager calls the StartService 
function. 


= Disabled—The service cannot be started. 
There are two additional values, available only for driver services: 
= Start at boot time—The device driver is started by the operating system loader. 


= Started by the system-—The device driver is started by calling the lolnitSystem 
function. 


Error Control 


This property specifies what action is taken by the startup program should the service fail to 
start properly during startup. The available values are: 


= Ignore Error—Logs the error and continues startup. 


= Normal Error—Logs the error, displays a message box informing the user of the 
problem, and continues startup. 
a Critical Error—lLogs the error, if possible, and restarts the system with the last-known- 


good configuration. If the las-known-good configuration caused the failure, the startup 
operation fails. 


Overall Install 


This property's value specifies how the installation handles a situation when this service 
cannot be installed for some reason. There are two possible resolutions: 


= Continue overall install if service fails to install 


= Fail overall install if service fails to install 


Load Order Group 


The value of this property is a string that names the load ordering group of which this service 
is a member. If the service does not belong to a load order group, this value should be either 
an empty string or NULL. 


Dependencies 


A list of names of services or load ordering groups that the system must start prior to starting 
this service. 
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Property Description 


Start Name The name under which the service is logged on. Leaving this field blank causes the service to 
be installed for the LocalSystem account. 


See the Windows Installer help topic Servicelnstall Table for information on the format for the 
StartName value. 


Password The password associated with the start name. Most services will have a blank value for this 
property. 

Arguments This property contains any command-line arguments or properties required to run the service. 

Description This property contains a localizable description of the service. It is typically set by the setup 
author. 

Features This read-only property contains the name of the feature with which this service is associated. 


Application Configuration 


Application Configuration View 


Application Configuration in Tuner involves adding or modifying properties that affect your setup as well as 
specifying properties for Add/Remove Programs in Control Panel for Windows 2000 and XP. You can also configure 
source resiliency using the Server Locations view, and customize user interface sequences from the Dialogs view. 


CorelDraw.mst (CorelDraw.msi) - InstallShield Tuner 
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Application Configuration fm 
S- Package validation 


E Prevalidation Application Configurat n 

B- Organization 
Product Properties Configure settings used by the application, such as properties that appear in 
® Features Add/Remove Programs or the dialogs that appear during installation. 

B- System Configuration 


|] Files and Folders 
Registry 


Shortcuts +] Server Locations X 
E Configure additional server locations to ensure source resiliency for the 


> INI Files windows Installer package. 
ey NT Services 


ODBC Resources 
Bey Application Configuration Setup Properties 
=4 Server Locations Configure properties required to successfuly install the package. These can 
[0] Setup Properties generally be edited from other views in Tuner. 


É} Dialogs 


Z} addjRet P 
Ea {Remove Programs Dialogs 


5- Package Preparation Selectively hide or show UI sequence dialogs for installation, maintenance, 
Postvalidation patch, and administrative installation modes, 
Package 
S- Additional Tools 
a Direct Editor F> | Add/Remove Programs 
aG) Configure properties that appear in the Windows 2000,and XP Add/Remove 
Programs in Control Panel. 
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The Windows 2000 and Add/Remove Programs in Control Panel differs from the previous Windows operating 
systems in many ways. Depending on how the Windows Installer setup is configured, the user has the option of 
removing, repairing, or changing the installation with the click of a button. Windows 2000 users are also be able to 
access additional information in Add/Remove Programs not available on previous platforms. With this information, it 
is easier for your end users to find technical support links, phone numbers, product update information, and 
information about your company. 


Add/Remove Programs functionality can also be disabled to limit the number of end users who have access this 
feature. 


Server Locations View 


If you install from a network server, and if you install features to run from the server or that will be advertised for 
installation on their first use, the applications may need access to the server sometime after the initial installation. The 
applications may also require access to the server if a file is deleted or becomes corrupt, as the application can copy 
the problematic file(s) automatically from the server. 


To ensure that users always have access to an available network server for these circumstances, you can copy the 
administrative installation to one or more additional servers, and then specify those servers from within this view. If 
the primary server should become unavailable, the Windows Installer will attempt to connect to the other servers 
specified here, in the order they are specified. If no server is found, the Windows Installer will prompt the user to 
specify the location of the server. 


Setup Properties View 


Even though Tuner provides you views to customize many areas of the Windows Installer package, it may be 
necessary to edit property values that are not available elsewhere. The Setup Properties view exposes the entries in the 
properties table (the underlying structure of Windows Installer packages). You can also add your own custom 
properties here. 
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CorelDraw.mst (CorelDraw.msi) - InstallShield Tuner 
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Properties exist in two formats: Private and Public. Private properties are set by the software vendor or by the 
Windows Installer during installation and cannot be altered. Private properties are always lowercase, and appear in 
Tuner in grayed out text. Public properties, which are always in capital letters, can also be set by the software vendor, 
but can be edited. Tuner also allows the addition of Public properties to the transform. The Public properties that you 
create can be edited or removed as necessary, whereas preexisting Public properties can only be edited. 


Before you begin changing properties in the Setup Properties view, ensure you know exactly what you are doing. The 


changes you make may cause validation errors, installation errors, or other unforeseen problems. 
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Dialogs View 


When customizing the Windows Installer package, you may want to disable particular panels that appear during the 
installation, administrative, patch, or maintenance sequences. You can do so from the Dialogs view. 


TestNTSvcView.mst (TestNTSvcView.msi) - InstallShield Tuner 
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The Dialogs view allows you to selectively enable or disable dialogs that 


appear in the four user interface sequences for the package you are 

customizing. By selecting the Installation mode, you can view the dialogs associated with 
the Installation Sequence, Admin Sequence, Maintenance Sequence, or Patch Sequence 
for the Windows Installer package. You can then click on the check box to the left of the 
dialog name to enable or disable it from display when users run the package in that 
mode, 


Dialogs: 


This view contains a list of each of the four installation modes (installation, administrative, maintenance, and patch), 
with the associated dialogs that appear as part of the UI sequence during the selected mode. You can enable or disable 
these dialogs by either the check box to the left of the dialog name, or by using the Show and Hide buttons. 


If you hide a dialog that appears in more than one sequence, the dialog is hidden during all sequences. 


During each installation mode, Windows Installer displays a Wizard containing a sequence of panels. However, the 
underlying Windows Installer technology actually uses a series of dialogs displayed in sequence. During run time, they 
are referred to as panels (as with other Wizards); at design time, they are individual dialogs that can be enabled or 
disabled as necessary. 
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Add/Remove Programs View 


The Windows 2000 and Windows XP Add/Remove Programs in Control Panel differs from the previous Windows 
operating systems in many ways. Depending on how the Windows Installer setup is configured, the user has the 
option of removing, repairing, or changing the installation with the click of a button. 


Windows 2000 and XP users are also able to access additional information in Add/Remove Programs in Control 
Panel not available on previous platforms. With this information, it is easier for your end users to find technical 
support links and phone numbers, product update information, and information about your company. 


You can set the following properties from the Add/Remove Programs view: 


CorelDraw.mst (CorelDraw.msi) - InstallShield Tuner 
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3- Package Validation Add/Remove Programs Setting fa 
Prevalidation Property ¥alue 
=) Organization Publisher URL http://www. corel.com 
Product Properties Product Info and Update URL http://www. yourcompany.com 
D Features Help URL http://www. halliburton.com/support 
=) System Configuration Help Telephone 1-888-839-9295 
o Files and Folders Contact Person Helpdesk 
Ei Registry Comments None 
OF Shortcuts Disable Modify Button 
a INI Files Disable Remove Button 
NT Services Disable Repair Button 
e ODBC Resources 
5- Application Configuration 
4 Server Locations 
[E] Setup Properties 
Dialogs z F 
Eee Disable Repair Button 


+- Package Preparation 
#1) Additional Tools This property, which corresponds to the ARPNOREPAIR property in the Setup | Give Us Feedback 
Properties view, provides a way to prevent users from running the application 


setup to repair missing or corrupt product files, 
When you double-click on the Value cell, No and Yes appear as choices in a combo box, 


This property refers to the repair option in Add/Remove Programs, and not to dialogs 
displayed when a setup is run in maintenance mode. 


Property Description 


Publisher URL Contains a URL for the publisher's home page. Corresponds to the ARPURLINFOABOUT 
property in the Setup Properties view. 


Product Info and Update Contains a URL that links to update information for the application. Corresponds to the 
URL ARPURLUPDATEINFO property in the Setup Properties view. 


Help URL Contains the Internet address for technical support. Product maintenance applets display this 
value. Corresponds to the ARPHELPLINK property in the Setup Properties view. 


Help Telephone Contains the telephone number that users can call for assistance with the product. 
Corresponds to the ARPHELPTELEPHONE property in the Setup Properties view. 
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Property Description 


Contact Person Contains a the name of the person to contact for help or information about the product. 
Corresponds to the ARPCONTACT property in the Setup Properties view. 


Comments Contains additional information that is provided for the user. Corresponds to the 
ARPCOMMENTS property in the Setup Properties view. 


Disable Modify Button Provides a way to prevent users from running the application setup to modify the product's 
installation. Corresponds to the ARPNOMODIFY property in the Setup Properties view. 


Disable Remove Button Provides a way to prevent users from running the application setup to remove (uninstall) the 
product from the user's computer. Corresponds to the ARPNOREMOVE property in the Setup 
Properties view. 


Disable Repair Button Provides a way to prevent users from running the application setup to repair missing or 
corrupt product files. Corresponds to the ARPNOREPAIR property in the Setup Properties view. 


Package Preparation 


Package Preparation View 


The final step in creating a customization involves two parts. First, you should postvalidate your transform and base 
Windows Installer package. This ensures that you have not introduced any errors into the installation, and may help 

you verify that you have corrected errors that existed in the base package. Secondly, you need to actually package the 
transform and base package for distribution. 


These steps are carried out through the following views: 


View Description 


Postvalidation Allows you to ensure that your Windows Installer package is valid. The difference is that it also 
checks your newly created transform to make sure it is valid in relation to the base package. 


Package When you have finished with your transform and postvalidation, the last step is to prepare the 
overall package so you can distribute it to your users (using a third-party tool such as Microsoft 


SMS). 


Postvalidation View 


Much like the Prevalidation view, the Postvalidation View allows you to ensure that your Windows Installer package is 
valid. The difference is that it also checks your newly created transform to ensure it is valid in relation to the base 
package. You can run the same internal consistency evaluators in the evaluation file, and receive the report back on 
the overall package and transform validity. By default, all ICEs are checked for the specified evaluation file. 


You can select the information level of the displayed results by checking the Show Info Messages, Show Error 
Messages, and Show Warning Messages check boxes. If any errors are present, the Windows Installer package is 
invalid. Warning messages highlight potential problems, but will not cause validation to fail. Informational messages 
display ongoing information during the validation process. 
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If you started off with a valid Windows Installer package, yet postvalidation fails, it is likely your problems relate to 
changes you made in the transform. Make sure you look at the Evaluation Files and Internal Consistency Evaluators 
topic to see what each ICE message means. You can also consult the online MSI Help reference, available from the 
Help Menu, for more details. 


It is also possible to start off with an invalid base package, but the postvalidation does not have any errors. If this 
happens, the properties you changed in your transform can bring the overall package and transform up to a valid 
package. 


Output of the postvalidation appears in the Output and Validation tabs of the Output Window. 


Viewing the Postvalidation Results 


As each ICE is run, Errors, Warnings, and Info messages are generated, and are listed in the Output tab at the bottom 
of the interface. 


x) |Validation started at 8/12/2003 1:07:57 PM ... 
WA Original Msi File - C:\AdminStudio Shared\AcroPra.msi 


ERROR Invalid Filename; Table: File, Column: FileName, Key(s); esdupdate.dll 
WARNING Component: Distiller_Win_NT_System_Files is a non-permanent system component 
WARNING Component: Distiller_Win9X_System_Ffiles is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9%_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9xX is a non-permanent system component 
WARNING Component: AdobePS W9X English Sys is a non-permanent system component 

Ig ji | 


| \ Output Á validation A Packaging F: 


Upon completion of the Postvalidation, the Validation tab is automatically selected, and all of the Errors, Warnings, 
and Info messages that were generated are listed in table format. Each table row lists an icon to indicate whether it is 
an Error © Warning à, or Informational message “¥, the name of the ICE that generated it, and a brief description 
of what caused it to occur. 


x ICE Type Description A| 
5 FE ; p = 
ERROR Invalid Filename; Table: File, Column: FileName, Key(s); esdupdate.dll 

WARNING Component: Distiller_Win_NT_System_Files is a non-permanent system component 
WARNING Component: Distiller_Win9x_System_Ffiles is a non-permanent system component 
WARNING Component: AdobePS_W9X_Korean_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseT_Sys is a non-permanent system component 
WARNING Component: AdobePS_W9X_ChineseS_Sys is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 
WARNING Component: Distiller_PPD_Sys_Roman_9X is a non-permanent system component | 
ii | >) 
Validation Á Packaging 7 
Ready NUM 3 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. 
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Tables 
_Malidation 
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E] AdminExecuteSequer _ 


AdminUISequence 
AdvtExecuteSequenc 
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AppSearch 
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n . . . 
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lement Eri Upar (26EDG0EE-S8S7-4105+ ELEMENTS 
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Elements_MFC42 {6E2D8031-BA14-4482-1 SystemFolder Version 


= (Not(Pro: 


(Version? 


Elements_UnicowDll {47523907-B94D-4C69- ELEMENTS 0 
ebook_Activex_GBDe {8ED34EF7-70FB-4057-) ACTIVEX 0 
eBook_Exchange_EDE {35044EDD-D070-484F- ACROBAT 0 

0 


Plugins_eBook {56454F03-FC42-4600-, PLUG_INS 

eBook_Exchange_EDE {?77ED68FF-1873-47B8-¢ ACROBAT 0 

Plugins_PreFlight_Utili {2676139B-729C-4EFD-, PLUGINS_PREFLIGH 0 Productc 

atai _PreFlight {7C947044-DA38-434D- PLUGINS_PREFLIGH’ 0 Productc 
x {7D445966-3545-42EF-E| PDFMAKER_COMMO| 0 

POMER TE {F78814E4-CAF5-4983- PDFMAKER_COMMO 0 

PDFMaker_TTFont  {FSEC244B-114F-4469-, FontsFolder 

Scan_Windows Files {4EC18029-40C8-4694- | WindowsFolder (Version? 

Resources_English  {B4E6E529-0648-48D5-) RESOURCE 


CoaramanDeceaweeaDEh J272FRAFN.0CFA-d4REA. EORIT DEM 


am] 


This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows 
Installer package and store them in your transform. For more information, see Direct Editor. 


If no errors appear in the results (providing you are displaying errors), then the package and transform are valid 
against the specific ICEs you specified, or against the entire evaluation file (if no ICEs were selected). 


It is possible for a package that passed the prevalidation to fail the postvalidation. Remember changes made in the 
Setup Properties can affect your installation. If your package fails postvalidation, check all changes made in the Setup 
Properties for accuracy. To identify the original Setup Properties, you can create a new transform file that can be 
deleted at any time. Changes made using the Direct Editor can also affect your installation's functionality. 
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Package View 


Package View 


When you have finished with your transform and postvalidation, the last step is to prepare the overall package so you 
can distribute it to your users (using a third-party tool such as Microsoft SMS). Tuner provides several different 
packaging options that can be used individually or in conjunction with one another. Note that Tuner does not actually 
perform the distribution; rather, it gathers the necessary files together, and copies them to a location you specify. You 
can then use some of the standard software distribution tools to roll out your customized package. 


The three subviews contained within the Package view ate: 


View Description 
Location Place the transform and base Windows Installer file on either an FTP server or network location. 
Setup Package the transform and base Windows Installer file with an executable launcher (Setup.exe) to 


begin the installation. You have the option of including the MSI Engine for the appropriate 
platform to ensure Windows Installer functionality. Setup.exe uses information contained in 
setup.ini to determine the package, associated transform, and any command-line parameters. 


SMS Package and prepare the transform and Windows Installer file for distribution using Microsoft 
SMS. Tuner can create a PDF file and/or an SMS file for your package and transform. 


These three subviews are also available through the Packaging Wizard, which can be accessed from the Project menu 
by selecting Package. 
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Location View 


It is from the Location View that you specify information regarding where to place the transform and initial Windows 
Installer file. You have the option to copy files to a network location, including performing an administrative 
installation, or copy files to an FTP server. 


CorelDraw.mst (Corel\Draw.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


jpeua@|DD|\t+e> mas eoo 


Package @ 
B- Package Validation Package O Network Location 
E Prevalidation Location 
EG} Organization A Setup 
Product Properties gy SMS 
D Features C:\Documents and Settings\PatriciaHowe\My Documents} 
& © System Configuration 
a Files and Folders © FTP Server 


Registry 4 n A o : 

Shortcuts You can upload this information to a FTP server, by specifying the Following information: FTP 
- Location (e.g. "ftp:{/servername/dirs" or just "servername/dirs"), username and the 

INI Files password (both are case sensitive). 

NT Services 


H ODBC Resources FTP Location 
5- Application Configuration 
3 Server Locations UserName 
[0] Setup Properties 
&} Dialogs Password 
a) Add/Remove Programs 
5- Package Preparation 
Postvalidation Location ¥iew 
z Package 


=) Additional Tools This view allows you to specify the location to store the installation 


fz] Direct Editor files {including transforms). If you select Network Location, you can 
specify or browse to the directory location. You can also perform an Administrative 
Install to this network location by checking the appropriate check box. 


The installation along with the transforms and the Files will be copied to the following network 
ocation. Press the browse button to locate the directory to copy the installation files to 


Alternately, you can distribute the installation files to an FTP server. If you select this 
option, you must specify the FTP location (URL), the user name under which to log in, 
and the password, 
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Setup View 


In the Setup view, you can set options that are used to create a Setup.exe file to launch both your transform and 
Windows Installer package. You have the option to include the MSI engine for Windows 95/98 and NT, as well as 
include any command-line arguments for the installation. 
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Package @ 


5- Package Validation Package Create Installation launcher (Setup.exe) 


- Ea Prevalidation ’ Location Setup.exe is a bootstrapping application that checks whether Windows Installer is currently 
&) Organization Setup installed in the machine, Select check boxes to include the required Windows Installer engine. 
Product Properties @ SMS Windows Installer command line arguments are stored in Setup. ini. 
& Features 
S- System Configuration [J Include win95/98 MSI Engine 
a Files and Folders [Include WinNT MSI Engine 
Registry 
Shortcuts Windows Installer Command Line Arguments 
INI Files l 
NT Services 
ODBC Resources 
4) Application Configuration 
g Server Locations 
[E] Setup Properties Setup ¥iew 
o Dialogs 
GG} Add/Remove Programs This view allows you to create a unified installation launcher 


-C Package Preparation (Setup.exe), and include the appropriate MSI engine for Windows 9x 
# Postvalidation 


or NT. You can also specify command-line arguments for Windows Installer. 
Package 


B-E Additional Tools 
fiz Direct Editor £j For a comprehensive list of Windows Installer command-line arguments, 
refer to the Command-Line Options topic in the MSI Help. 
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SMS View 


In many cases, you may want to perform distribution of the transform and Windows Installer package using Microsoft 
SMS. Tuner provides a way to create both a Package Definition File (PDF) or an SMS file in the SMS View. 
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Package %9 
=) Package Validation PETE RE 
acai ; ackage Definition File 

pee i Prevalidation i Location 4 package definition file is a text file that contains all the information necessary to create a 
CQ Organization Setup software distribution package for an application. SMS 1.2 or earlier uses PDF file extension. 

Product Properties s SMS 2.0 or later uses SMS file extension. 

® Features 

m P. finition File (SMS 1. li 

S-E System Configuration E] Create Package Definition File (SMS 1.2 or earlier) 


Files and Folders C] create SM5 file (SMS 2.0 or later) 

Registry If your installation will be run in a Microsoft Systems Management Server (SMS) 
(Fy Shortcuts environment, you can c n .MIF file in t s directory to describe 
$ INI Files your application, MIF star or Management Inf 


Sa NT Services 
fp) ODBC Resources 

© Application Configuration 

4 Server Locations 

[E] Setup Properties 

£ Dialogs 

a) Add/Remove Programs 
=) Package Preparation 


Postvalidation 
Package 
= Additional Tools All options in this view relate to the Microsoft Systems Management Give Us Feodbock 


Direct Editor Server (SMS) environment and preparing your base Windows Installer 
package and transform(s) for distribution using SMS. You can create a Package 
Definition File (PDF) to use with SMS 1.2 or earlier, or an SMS file for SMS 2.0 or 
later, If you are creating an SMS file, provide values for the Install MIF Filename, 
Uninstall MIF Filename, and Serial Number fields. Tuner will instruct SMS to 
automatically create a Management Information Format (MIF) file in the Windows 
directory at deployment time. 


stall MIF Filename 


Uninstall MIF Filename 


Select the file type(s) you want to create. If you create an SMS file, Tuner can instruct SMS to create a Management 
Information Format (MIF) file when SMS deploys the package and transform. If you want to do this, provide the 
Install MIF Filename, Uninstall MIF Filename, and serial number. 


For more information about Microsoft SMS, consult the SMS documentation. 


Additional Tools 


Additional Tools View 


Tuner includes an extremely flexible additional tool: the Direct Editor. Using this tool, you can directly edit the 
Windows Installer tables that make up the Windows Installer package. This provides you with extremely granular 
control over the transform you are creating. 
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Direct Editor 


Windows Installer packages are relational databases consisting of dozens of interrelated tables. These tables reflect the 
application's features, components, relationship between features and components, registry information, and user 
interface. 


The Direct Editor allows you to edit values in the MSI tables of the base Windows Installer package and store them in 
your transform. As you change values elsewhere in your transform, those changes are reflected in the Direct Editor, 
and vice versa. The complete list of MSI tables contained in the installation package is displayed in the left pane. 
When you select a table, the contents are displayed in the right pane. 
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4 Package Validation Tables Action - s72 |Condition- 5255 |Sequence - 12 
Prevalidation _alidation CostInitialize 50 
S- Organization ActionText FileCost 100 
Product Properties AdminExecuteSequence CostFinalize 150 
©) Features AdminUISequence 7 Installvalidate 
5- System Configuration AdvtExecuteSequence InstallInitialize 
Files and Folders AdvtUISequence InstallAdminPa 
Registry E Appid a InstallFiles 
Shortcuts AppSearch InstallFinalize 
INI Files BBControl SystemFolder. 
NT Services Billboard CommonFilesF: 
ODBC Resources Binary Click here to a 
S- Application Configuration BindImage 
g Server Locations CCPSearch 
[E] Setup Properties CheckBox 
É Dialogs Class 
ro) Add/Remove Programs E ComboBox 
=) © Package Preparation CompLocator 
Postvalidation E Complus 
# Package Component 
5- Additional Tools Condition 
Direct Editor 
ControlCondition 
ControlEvent 


AdminExecuteSequence - 10 rows 


Working Directly with MSI Tables 


The Tuner Direct Editor provides the ability to work directly with MSI tables. This includes the ability to edit the 
contents, as well as find and replace values. 


When viewing or editing specific tables, pressing F1 launches the Microsoft Windows Installer help system to the 
appropriate table, if it is a standard Windows Installer table. When F1 is pressed while viewing a non-standard table, 
the Windows Installer help system launches to its default topic. Consult the software vendor for information about 
custom tables. 


InstallShield Software Corporation © 2004 530 


AdminStudio 5.5 User Guide 9 Customizing Packages 


Table Functionality 


The following functionality is available for tables: 


Keyboard 

Function Shortcut Description 

Add Records Insert Adds a new record to the table. 

Delete Records Del Deletes the selected record after user confirmation. Referential integrity is 
not maintained. 

Cut Row(s) Ctrl+X Enables users to cut single or multiple rows or cells in the grid to the 
clipboard. 

Copy Row(s) Ctrl+C Copies the selected cell or row in the grid to the clipboard. 

Paste Row(s) Ctrl+V Pastes the contents of the clipboard into a given cell or row(s). 


Editing Tables by Launching the Direct Editor from the Validation Tab 


Upon completion of a Pre- or Postvalidation, the Validation tab is automatically selected, and all of the Errors, 
Warnings, and Info messages that were generated are listed in table format. Each table row lists an icon to indicate 
whether it is an Error © Warning A or Informational message 4, and the name of the ICE that generated it, and a 
brief description of what caused it to occur. 


xi] Ice Type Description A 
2 a= : = 
| ERROR Invalid Filename; Table: File, Column: FileName, Key(s)}: esdupdate. dll 
WARNING Component: Distiller_Win_NT_System_Ffiles is a non-permanent system component 

| WARNING Component: Distiller_Win9X_System_Files is a non-permanent system component 

| WARNING Component: AdobePS_w9x_Korean_Sys is a non-permanent system component 

| WARNING Component: AdobePS_w9x_ChineseT_5ys is a non-permanent system component 

| WARNING Component: AdobePS_w9%x_Chinese5_5ys is a non-permanent system component 

| WARNING Component: Distiller_PPD_Sys_Roman_9X_Base is a non-permanent system component 

| WARNING Component: Distiller_PPD_Sys_Roman_9X is a non-permanent system component 5| 

i >) 

I} Validation Á Packaging j 

Ready NUM 


If a row is grayed out, it indicates that the table cannot be edited in the Direct Editor (perhaps because it is in an 
external package). If a row is active, you can double-click on it to open that row's associated table. The Direct Editor 
is launched and the table and/or table cells that are causing the problem are highlighted in red. 
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This feature makes it very easy for you to use the Direct Editor to edit values in the MSI tables of the base Windows 
Installer package and store them in your transform. 


Resizing Table Columns in the Direct Editor 


When you initially open the Direct Editor, the selected table's columns ate listed in a compact format so that the 
maximum number of columns are displayed. 


To automatically resize a column so that its width matches that of its longest entry, double-click on the column 
heading. This new column width setting is automatically saved and will be implemented the next time you view this 


table column in the Direct Editor. 
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Sorting Table Columns in the Direct Editor 


To sort a table column, click the column heading once. The order will toggle between ascending and descending. 
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Import INI File Wizard 


Tuner allows you to import any existing INI files that you may have created previously. To import a INI file, you need 
to launch the Import INI File Wizard. 


The Wizard consists of the following panels: 


Welcome 

Import INI File 

Import Conflict Options 
Finishing INI File Import 


Within the INI Files view, right-click on a folder under the Destination Computer node (or right-click on the 
Destination Computer node to add a folder first), and then select Import INI File. The Wizard that appears prompts 
you for the location of the INI file, as well as what to do when there are conflicts arising from duplicate values. When 
import occurs, Tuner merges the contents of the INI file with existing INI file data. 


Welcome Panel 


The Import INI File Wizard allows you to import data contained in an INI file into your transform. 


Import INI File Wizard. 


Welcome to the 
INI File Import Wizard 
This wizard will allow you to merge the contents of an INI file 


(ini) File with the data in the IniFile table for the selected 
component. 


Click Next to proceed to the Import INI File Panel. 
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From this panel, you need to specify the name of the INI file (ini) you want to import into your transform. 
Alternatively, click Browse and navigate to it. 


Import INI File Wizard 


Import IniFile. 
Select the Inifile, 


Enter the path and name of the INI file that you want to import, or click Browse to locate 
the file. 


INI File: 
| C:\AdminStudio Shared\issnapshot. ini 


Browse... 


Click Next to proceed to the Import Conflict Options Panel; click Back to return to the Welcome Panel. 


Import Conflict Options Panel 
The Import Conflict Options panel allows you to specify how you want to handle duplicate INI file data. 


Import INI File Wizard 


Import Conflict Options 
Select a method for overwriting duplicate keys, 


While importing data From the INI file, the wizard may encounter INI file keys and values 
already present in the IniFile table. 


Specify how the wizard should handle duplicate keys. 


If conflicts exist, the wizard will overwrite the INI file keys and values with any 
duplicate keys From the INI File (ini). 


© Do not overwrite the data in the IniFile table 


If duplicate keys and values are encountered, the wizard will not overwrite the 
existing data in the IniFile table. 


InstallShield Software Corporation © 2004 534 


AdminStudio 5.5 User Guide 9 Customizing Packages 


Select one of the following options for the Wizard to use to determine how to handle these conflicts: 


Option Description 

Overwrite the data in If conflicts exist, the Wizard will overwrite the INI file keys and values with any duplicate 
the IniFile table keys from the registry file (reg). 

Do not overwrite the If duplicate keys and values are found, the Wizard will retain the existing INI file data and 
data in the IniFile table not overwrite it. 


Click Import to import the .ini file. When the file has been imported, the Finishing INI File Import Panel is displayed. 
Click Back to return to the Import INI File Panel. 


Finishing INI File Import Panel 
This panel appears following import of the .ini file. Click Finish to exit the Wizard and return to the INI File view. 
Import INI File Wizard 


Finishing Inifile Import. 
The wizard will Finish importing your Inifile data in a moment. 


INI File Import Complete 


Import Complete. 


COCO) 


Click Finish to close the wizard 


Import REG File Wizard 


Tuner allows you to import any existing REG files that you may have created previously. To import a REG file, you 
need to launch the Import REG File Wizard. 


The Wizard consists of the following panels: 


m Welcome 

m Import Registry File 

m Import Conflict Options 
m Finishing Registry Import 


To launch the Import REG File Wizard, go to the Registry view, right-click on one of the registry hives or on a 
registry key you have added, and select Import REG File from the context menu. 
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Destination Computer Registry View Desti 
My Computer Nan 
FB ae HKEY_C ‘ 
> 
© HKEY _CURRENT USE "S" (Insert) 
cH (Sy HKEY_LOCAL_MACHI) Copy (Ctrl+C) 
£ HKEY_USER_SELECTA Paste (Ctrl+V) 
(© HKEY_USERS 
(Del) 
Rename (F2) 
Create Key At Install 
Delete Key At Uninstall 
Both Create And Delete 
Import REG File... 


The Wizard that appears prompting you for the location of the registry file, as well as what to do when there are 
conflicts arising from duplicate keys. When import occurs, Tuner merges the contents of the REG file with existing 


registry data. 
Welcome Panel 


The Import REG File Wizard allows you to add registry data contained in a registry file (.reg) into your transform. 


Import REG File Wizard. 


Welcome to the 
Registry Import Wizard 
COM a... 
This wizard will allow you to merge the contents of a 


Registry (.req) file with the Registry data for the selected 
component, 


Click Next to proceed to the Import Registry File Panel. 
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Import Registry File Panel 


From this panel, you need to specify the name of the registry file (.ceg) you want to import into your transform. 
Alternately, click Browse and navigate to it. 


Import REG File Wizard 


Import Registry File. 
Select the registry File. 


Enter the path and name of the Registry File that you want to import, or click Browse to 
locate the file, 


Registry File: 


Browse... 


Click Next to proceed to the Import Conflict Options Panel; click Back to return to the Welcome Panel. 


Import Conflict Options Panel 


The Import Conflict Options panel allows you to specify how you want to handle duplicate registry keys and values. 


Import REG File Wizard 


Import Conflict Options 
Select a method For overwriting duplicate keys, [mo] 


While importing data from the Registry file, the wizard may encounter registry keys and 
values already present in this registry data, 


Specify how the wizard should handle duplicate keys. 


If conflicts exist, the wizard will overwrite the registry keys and values with any 
duplicate keys from the Registry (.reg) file. 


O Do not overwrite the registry data 


IF duplicate keys and values are encountered, the wizard will not overwrite the 
existing registry data. 
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Select one of the following options for the Wizard to use to determine how to handle these conflicts: 


Option Description 


Overwrite the registry |f conflicts exist, the Wizard will overwrite the registry keys and values with any duplicate 


data keys from the registry file (reg). 
Do not overwrite the If duplicate keys and values are found, the Wizard will retain the existing registry data 
registry data and not overwrite it. 


Click Import to import the .reg file. When the file has been imported, the Finishing Registry Import Panel is 
displayed. Click Back to return to the Import Registry File Panel. 


Finishing Registry Import Panel 


This panel appears following import of the .reg file. Click Finish to exit the Wizard and return to the Registry view. 


Import REG File Wizard 


Finishing Registry Import. 
The wizard will finish importing your registry data in a moment. 


REG File Import Complete 


Packaging Wizard 


The Packaging Wizard provides a way to step through the packaging process for the transform and Windows Installer 
package. Please note that this packaging merely places the installation on a network location or FTP server, creates a 
Setup.exe file, and/or creates files for SMS distribution. It does not actually distribute the installation to client 
machines. To invoke the Packaging Wizard, select Packaging Wizard from the Project menu, or select the Packaging 


Wizard Le} button from the toolbar. 
The Packaging Wizard consists of the following four panels: 


Location 
Setup.exe 

SMS 

Package Summary 
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Location Panel 


The first panel of the Packaging Wizard allows you to specify the location to store the installation files (including 
transforms). If you select Network Location, you can specify or browse to the directory location. 


Alternately, you can copy the installation files to an FTP server. If you select this option, you must specify the FTP 
location (URL), the user name under which to log in, and the password. 


Packaging Wizard 


Location 
Network Location or FTP location 


The installation along with the transforms and the files will be copied to the Following network 
location, Press the browse button to locate the directory to copy the installation files to. 


Documents and Settings\PatrideHowelMy Docunents| | 
| 


O FTP Server 


You can upload this infor ying the Following information; FTP 
neag iei, or its") and the 
rd (both are j 


TP Location 


Usertame 


rd 


Click Next to proceed to the Setup.exe Panel, or Cancel to terminate the Packaging Wizard. 
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Setup.exe Panel 


This Packaging Wizard panel allows you to include a setup.exe launcher for your package and transform, and include 
the appropriate MSI engine for Windows 9x or NT. You can also specify command-line arguments for the Windows 
Installer. 


Packaging Wizard 


Setup.exe 
Options For Setup.exe and Windows Installer 


} 
Setup.exe is a bootstrapping application that checks whether Windows Installer is currently 
installed in the machine, Select check boxes to include the required Windows Installer engine. 
Windows Installer command line arguments are stored in Setup. ini. 
[C] Include Win95/98 MSI Engine 


[C] Include WinNT MSI Engine 


Windows Installer Command Line Arguments 


| 


Click Next to proceed to the SMS Panel, Back to return to the Location Panel, or Cancel to terminate the Packaging 
Wizard. 
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In many cases, you may want to perform distribution of the transform and Windows Installer package using Microsoft 
SMS. Tuner provides a way to create both a Package Definition File (PDF) or an SMS file in the SMS View. Select the 
file type(s) you want to create. If you create an SMS file, Tuner can instruct SMS to create a Management Information 
Format (MIF) file when SMS deploys the package and transform. If you want to do this, provide the Install MIF 
Filename, Uninstall MIF Filename, and serial number. 


Packaging Wizard 


SMS 
Options For SMS 


Package Definition File 
4 package definition file is a text File that contains all the information necessary to create a 
software distribution package for an application. SMS 1.2 or earlier uses PDF File extension. 
SMS 2.0 or later uses SMS file extension. 


C] Create Package Definition File (SMS 1.2 or earlier) 


TF your installation will be run in a Microsoft Systems Management Server (SMS) 
environment, you can create an .MIF file in the Windows directory to describe 
your application, MIF stands for Management Information Format. 


Install MIF Filename 


Uninstall MIF Filename 


Serial Number 


Click Next to proceed to the Packaging Summary Panel, Back to return to the Setup.exe Panel, or Cancel to terminate 
the Packaging Wizard. 
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Packaging Summary Panel 


The Package Summary panel informs you of the packaging options selected in the three previous panels. If you need 
to make changes, use the Back button to return to the previous panel. The Cancel button aborts the packaging 
operation. If you are satisfied with the selected options, click Finish to copy the installation files to the specified 
location and/or create Setup.exe and SMS files. 


Packaging Wizard 


Packaging Summary 
Options selected in the previous panels. 


Summary 


Location 
Copy To Network Location: C:\Documents and Settings\PatriciaHowe\My Documents} 


Setup.exe 
Setup.Exe : Yes 
WinNT Engine : No 
Win9x Engine : No 
Windows Installer Command Line: 


SMS 
PDF (SMS 1.2 or earlier) ; No 
PDF file (SMS version 2.0 or later) : Yes 
Install Filename: 
Uninstall Filename: 
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Application isolation is one solution to component versioning conflicts, commonly known as "DLL Hell." Isolation 
reduces versioning conflicts by modifying an application so it always loads the versions of components—such as 
DLLs—with which it was originally developed and tested. This is accomplished by providing DLLs and other shared 
components for specific applications, and placing information traditionally stored in the registry into other files that 
specify the locations of these isolated components. Application isolation provides increased stability and reliability for 
applications because they are unaffected by changes caused by installation and ongoing maintenance of other 
applications on the system. 


Depending on the isolation method used in the Application Isolation Wizard™, you can partially or totally isolate an 
application. When using assemblies and manifests to isolate applications for Windows XP systems, the assemblies can 
be updated following deployment without necessitating application reinstallation. 


Reasons to Isolate Applications 


You would want to isolate an application if: 


m You want to resolve incompatibilities between different versions of shared components. 


E You want to reduce the complexity of the installation by storing COM activation data in a manifest instead of the 
registry. 


m You want to insulate the application from changes to shared components. 


O 


Following isolation, you can use the Dynamic Dependency Scanner in DevStudio to verify isolated files are loaded from 
a different directory. 


Reasons Not to isolate an Application 


You would not want to isolate an application if, following application isolation, you discover that the application no 
longer works because of an internal dependency on a component that has been moved during the isolation process. 
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Launching the Application Isolation 
Wizard™ 


To launch the Application Isolation Wizard: 
1. Launch AdminStudio. 


2. From the Tools Gallery, click the Application Isolation Wizard icon on the left side. 


$ 
Application Isolation 


wizard 


The Application Isolation Wizard launches and you can immediately begin the application isolation 
process. 
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Isolation Methods 


There are two isolation methods supported by the Application Isolation Wizard™: Manifests and Assemblies and 
Windows Installer Isolated Components. 


Assemblies and Manifests 


Application isolation using assemblies and manifests is the recommended isolation method for Windows XP. These 
assemblies and manifests provide the same end result as Windows Installer isolated components, but keep all 
information outside of the registry and do not require the components to be installed in the same folder as the 
application. This reduces the chance of errors after isolation resulting from how the application was written. 


Assemblies and manifests only work under the Windows XP operating system. 


Windows Installer Isolated Components 


Application isolation using Windows Installer isolated components is for Windows 98 SE, Me, and 2000. It can also 
be used on Windows XP, but using assemblies and manifests is the better solution. The isolated component method 
copies shared files (typically DLLs) into an application's folder instead of a shared location. The application then uses 
these files instead of global ones, preventing modifications made by other applications from affecting the shared files. 
As a result, the application always uses the versions of these files with which it was deployed. 


To instruct an application use the private files rather than shared versions, the Application Isolation Wizard populates 
the IsolatedComponent table with the necessary logic to use private files stored in the same folder as the application. 
When Windows Installer performs the setup, data from the IsolatedComponent table populates a .local file, which 
ultimately directs how to use the private files. 


Windows Installer isolated components still require some information to be written to the registry, and also require 
the associated components to be in the same folder as the application. While in most cases this will still provide 
required isolation, depending on how the application was written, the movement of these associated components 
from their original locations may prevent the application from functioning correctly. 
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Assemblies 


Assemblies are DLLs or other portable executable files that applications require to function. Under Windows XP, 
these can be either shared or private. Private assemblies are typically stored in the same directory as the application 
they support. Shared assemblies are stored in the WinSxS directory, and are digitally signed. 


By creating manifests for assemblies, the Application Isolation Wizard™ allows you to create self-contained 
applications that can use different versions of the same DLL or other portable executable, without any version 
conflicts. 


Shared Assemblies 


Shared assemblies are assemblies available to multiple applications on a computer. Applications that require these 
assemblies specify their dependence within a manifest. Multiple versions of shared assemblies can be used by different 
applications running simultaneously. 


These assemblies are stored in the WinSxS directory, and must be digitally signed for authenticity. After deployment, 
the version of shared assemblies can be changed, allowing for changes in dependencies. 


Private Assemblies 


Private assemblies are assemblies created for exclusive use by an application. They are accompanied by an assembly 
manifest, which contains information normally stored in the registry. Private assemblies allow you to totally isolate an 
application, eliminating the possibility that dependent files may be overwritten by other applications. 


These assemblies are always stored in the same location as their associated executable. 
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The Application Isolation Wizard™ can create two types of manifests: application manifests and assembly manifests. 


Manifest Type Description 


Application Application manifests are XML files that describe an isolated application. This descriptive information 
includes the relationship between the application and its dependent files. 


Typically, the naming convention for a manifest is ApplicationName.Extension.manifest. For example, 
if the application was HelloWorld.exe, the manifest file is called HelloWorld.exe.manifest. 


Assembly Assembly manifests are XML files that describe an application's assemblies. This includes components 
such as DLLs. Information stored in the assembly manifest, such as COM registration information, 
Prog|Ds, etc., is usually stored in the Registry. However, by making it independent from the registry, 
only that application can use the dependent files described in the manifest. This enables you to have 
multiple versions of the same DLL or other portable executable file on a system without generating 
compatibility conflicts. 


Typically, the naming convention for a manifest is AssemblyName.Extension.manifest. For example, if 
the component was Goodbye.dll, the manifest file is called Goodbye.dll.manifest. 


Manifests as New Components 


When you create manifests, the Application Isolation Wizard supports putting them into new components. If you do 
not select this option from the Advanced Options dialog, the manifest will be added to the same component as the 
assembly. 
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Like conventional signatures, digital signatures identify you (or your organization) to end users. In the context of 
application isolation, a digital signature identifies you or your organization as the creator of shared assemblies. This 
ensures that the identity of a shared assembly can be verified for authenticity. Digital signatures in the Application 
Isolation Wizard™ require a combination of a digital certificate and a code signing technology. 


Certificates 


Digital certificates identify you and/or your company to end users to assure them the assembly they are about to use 
has not been altered. They are issued by a certification authority such as VeriSign, or created using a combination of 
software publishing credentials (spc) and a private key (.pvk), both also issued by a certification authority. The 
certificate includes the public cryptograph key, and, when used in combination with a private key, can be used by end 
users to verify the authenticity of the signor. 


You can create a certificate file from the constituent PVK and SPC files and import it into the certificate store using 
directions found on the Microsoft DevStudio Network Web site in the article PVK Digital Certificate Files Importer. 
You can then export the certificate (.cer) file for use outside of the certificate store. 


Certificate files must be 2048-bit or higher. For more information, see the article: Assembly Signing Example on the 
Microsoft DevStudio Network Web site. 


Code Signing Technologies 


The Application Isolation Wizard™ supports two code signing technologies: 


Technology Description 

Credentials Credentials consist of both software publishing credentials (.spc file) and a private key 
(.pvk file). These two files are required in conjunction with the certificate to sign shared 
assemblies. 


Certificate Name in the Using Microsoft's certificate store technology, the combined software publishing credentials 
Store and private key can be placed in a repository for multiple uses. The name of the certificate 
is provided as opposed to the constituent files in the Credentials code signing technology. 
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Software Publishing Credentials 


You must supply a certification authority with specific information about your company and software to obtain 
software publishing credentials in the form of an .spc file. Your software publishing credentials are used to generate a 
digital signature for your assembly. 


The .spc file and .pvk (private key) file you enter as in the Digital Signature tab of the Advanced Options dialog 
compose the digital certificate for shared assemblies. 


Contact a certification authority such as VeriSign for more information on the specifics of software publishing 
credentials. 


Certificate Store 


To perform code signing, both private key and software publishing credential information must be supplied. This 
must occur each time a package is signed. However, the certificate store serves as a central repository for this 
information, allowing you to associate the same credentials and key with multiple packages. This simplification is 
particularly useful when isolating applications, as typically the code signing information will be identical for all shared 
assemblies. Ultimately, the certificate store removes the burden of managing private key and software publishing 
credential information. 


You can create a certificate file from the constituent PVK and SPC files and import it into the certificate store using 
directions found on the Microsoft DevStudio Network Web site in the article PVK Digital Certificate Files Importer. 
You can then export the certificate (.cer) file for use outside of the certificate store. 


Private Keys 


A private key (a file with the extension .pvk) is granted by a certification authority. The Application Isolation 
Wizard™ uses the private key you enter in the Digital Certificates tab of the Advanced Options dialog to digitally sign 
your shared assembly and ensure end users of its content's authenticity. 


The .spe (software publishing credentials) file and .pvk file you enter in the Digital Signature tab compose the digital 
certificate for shared assemblies. 


Contact a certification authority such as VeriSign for more information on the specifics of software publishing 
credentials. 
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Isolating Applications 


To isolate applications within a Windows Installer package (.msi) or merge module 
(.msm): 


1. Launch the Application Isolation Wizard™. The Welcome Panel appears. 


InstallShield Application Isolation Wizard 


Welcome to the Application Isolation 
Wizard 


This wizard will scan a Windows Installer file installation 
package [.msi] or merge module [.msm)] and isolate 
applications within it. 


e. 
S | ) What is application isolation? 


Isolation ensures that applications always use the specific 
shared and support files with which they were installed. 
Application Isolation prevents the overwriting of previous 
versions of shared components, and ensures that other 
applications do not overwrite the versions of shared and 
support files required by your application. 


Application Isolation Wizard 


Windows Installer File Selection 


Specify the Windows Installer file on which you want to perform application 
isolation. 


Click Browse to identify the Windows installer package (.msi) or merge module (.msm) that 
will be scanned for application files that can be isolated, 


Windows Installer File: 


Ej (eon. 
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3. From the Windows Installer File Selection Panel, specify the Windows Installer package (.msi) or merge 


module (.msm) containing applications you want to isolate. Click Next. The Isolation Method panel 
appears. 


Application Isolation Wizard 


Isolation Method 
Select the method used for application isolation. 


Manifests 
If your installation will be deployed only on Windows XP, use manifests for isolation, 


Use manifests for isolation 


Windows Installer Isolated Components 


TF your installation will be deployed on Windows 98 SE, Me, and/or Windows 2000, use 
Windows Installer Isolated Components. 


Use Windows Installer isolated components For isolation 


i ) Tf your installation will be deployed on Windows XP and any of the other supported 


operating systems, select both options. (Your installation package size will increase as a 
result.) 


4. From the Isolation Method Panel, select the isolation method(s) you want to use. 


5. Ifyou are using manifests, you can click Advanced to configure manifest properties and digital 
signature information (if required) on the Advanced Options Dialog. 


6. Click Next. The Summary Information panel appears. 


Application Isolation Wizard 


Summary Information 
Verify your selections before starting the application isolation process. 


Package being isolated: Orca.msi 


NOTE: 
The MSI file selected has the schema 100, 
You need a schema of 150 or higher For using the Assembly tables, The Application Isolation — 


Application Assembly Manifests: 
Company. Division. AppAssembly2 (1.0.0.1) -- Orca,exe, manifest 
- Local Assemblies 
- Company. Division. Assembly2 (1.0.0.1) -- Company. Division. Assembly2, manifest 
Components 
- Global_¥C_CRT,51D569E0_8428_11D2_B962_006097C4DE24 


Camnnanent« v 


ll | > 


Click Modify to make changes to the overall isolation settings. 


7. From the Summary Information Panel, confirm the isolation selections. 
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8. Ifyou want to manually configure isolation, click Modify. 


10 Isolating Applications 


m |f you are using manifests to isolate your application—either alone or in conjunction with Windows 


Installer isolated components—the Manifest and Assembly Design Dialog appears. 


Manifest and Assembly Design 


Applications to be Isolated: 


Assemblies to be added in an Application: 


s0 
F Company.Division.Assembly2 
a- orea.exe 
FA Company. Division. Assembly 1 


Assembly Name 


Company. Division. Assembly 1 
Company. Division, Assembly2 


New ¥ | Delete 


Isolated Components Design 


Applications to be Isolated: 


Application 
| Orca.exe 
= | Orca.exe 


Select All Clear All 


es | r 


m |f you are only using Windows Installer isolated components to isolate the application, the Isolated 
Components Design Dialog appears. 


Eiles to Isolate for Selected Application: 


File Name 


evalcom.dll 
mesyert.dll 
mFc42.dll 
mFc42u.dll 
messtkprp.dll 
darice.cub 
logo.cub 
mergemod.dll 
mergemod.cub 
orca.dat 


Destination 

CommonFilesFolder\Microsoft Shared\MSI Tools 
SystemFolder 

SystemFolder 

SystemFolder 

SystemFolder 

ProgramFilesFolder\Orca 
ProgramFilesFolder\Orca 

CommonFilesFolder\ Microsoft Shared\MSI Tools 
ProgramFilesFolder\Orca 
ProgramFilesFolder\Orca 


> 


Show: |All Files 
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9. After you have completed manually configuring the isolation, click OK to return to the Summary 
Information Panel. 


10. Click Isolate. The Application Isolation Progress Panel appears. 


Application Isolation Wizard 


Application Isolation Progress 
The Application Isolation Wizard is isolating components. 


Isolating components, Please wait... 
Isolating file 'mfc42.dll' for 'Orca.exe! 


Finish 


When the Isolation Application Wizard is complete, the Completing the Application Isolation Wizard 
Panel is displayed, providing feedback on whether the Application Isolation Wizard was successful. 


InstallShield Application Isolation Wizard 


Completing the Application Isolation Wizard 


You have successfully completed the Application Isolation 
Wizard. 


The applications in the following file have been isolated and 
written to a new output package. 


Original Package: 
C:\AdminStudio Shared\Orca.msi 


Output Package: 
C:\AdminStudio Shared\Orca_lsolated2. msi 


Click Finish to close this wizard. 


C ag el 


11. From the Completing the Application Isolation Wizard Panel, click Finish. 


InstallShield Software Corporation © 2004 555 


AdminStudio 5.5 User Guide 10 Isolating Applications 


Setting Assembly Naming Conventions 


To set the default naming convention for assemblies: 


1. Launch the Application Isolation Wizard™. The Welcome Panel opens. 


InstallShield Application Isolation Wizard 


Welcome to the Application Isolation 
Wizard 


This wizard will scan a Windows Installer file installation 
package [.msi] or merge module [.msm] and isolate 
applications within it. 


. 
® | ) What is application isolation? 


Isolation ensures that applications always use the specific 
shared and support files with which they were installed. 
Application Isolation prevents the overwriting of previous 
versions of shared components, and ensures that other 
applications do not overwrite the versions of shared and 
support files required by your application. 


Application Isolation Wizard 


Windows Installer File Selection 


Specify the Windows Installer file on which you want to perform application 
isolation. 


Click Browse to identify the Windows installer package (.msi) or merge module (.msm) that 
will be scanned for application files that can be isolated, 


‘Windows Installer File: 


v | Browse... 
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3. From the Windows Installer File Selection panel, specify the Windows Installer package (.msi) or merge 


module (.msm) containing applications you want to isolate. Click Next. The Isolation Method Panel 
opens. 


Application Isolation Wizard 


Isolation Method 
Select the method used for application isolation. 


Manifests 
If your installation will be deployed only on Windows XP, use manifests for isolation, 


Use manifests for isolation 


Windows Installer Isolated Components 


TF your installation will be deployed on Windows 98 SE, Me, and/or Windows 2000, use 
Windows Installer Isolated Components. 


Use Windows Installer isolated components For isolation 


i ) Tf your installation will be deployed on Windows XP and any of the other supported 


operating systems, select both options. (Your installation package size will increase as a 
result.) 


4. Select the Use manifests for isolation option. 
5. Click Advanced. The Manifest Options tab of the Advanced Options Dialog opens. 


Advanced Options 


Manifest Options | Digital Signature | 


Assembly Type 


© Create private side-by-side assemblies in the application folder 
© Create shared side-by-side assemblies in WinSxS directory 


i Manifests for shared assemblies must be digitally signed. Click 
the Digital Signature tab to specify certificate details. 


Assembly Naming Conventions 
Company: 


| Company 


Division: 


[Division | 


i Specify Company and Division to standardize how assembly 
Db names are constructed. Assembly names will be specified in 
the form “Company. Division. Assembly". 


Create new component for each assembly 


6. Enter your Company name and Division. These two fields create the default assembly naming 
convention (in the form "Company.Division.Assembly" followed by a number). 
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To edit the Assembly Name, you can also click Modify from the Summary Information Panel later in the 
Wizard to access the Manifest and Assembly Design Dialog, and then click Properties to access the 
Application Manifest Properties Dialog, where you can edit the Assembly Name. 


7. Click OK. You are returned to the Isolation Method Panel. 


8. Click Next. The Summary Information Panel opens. 


Application Isolation Wizard 


Summary Information 
Verify your selections before starting the application isolation process. 


Package being isolated: Orca.msi 


NOTE: 
The MSI file selected has the schema 100, 
You need a schema of 150 or higher for using the Assembly tables, The Application Isolation 


Application Assembly Manifests: 
Company. Division. 4ppAssembly2 (1.0.0.1) -- Orca,exe, manifest 
- Local Assemblies 
- Company. Division, Assembly2 (1.0.0.1) -- Company. Division. Assembly2.manifest 
Components 
- Global_V¥C_CRT.51D569E0_8428_11D2_B962_006097C4DE24 


Camnoanent« 


Click Modify to make changes to the overall isolation settings. 


9. Click Isolate to proceed with isolation using the specified naming convention. 


Assemblies created during application isolation will follow the naming convention as specified. 
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Modifying the Default Isolation 
Recommendations 


To modify the default isolation recommendations when only using Windows Installer 


isolated components: 


1. From the Summary Information Panel of the Application Isolation Wizard™, click Modify. The Isolated 
Components Design Dialog is displayed. 


Isolated Components Design 


Applications to be Isolated: 
Application 


Bl orcacxe 


| 
| = | Orca.exe 


Files to Isolate for Selected Application: 


File Name 
evalcom.dll 
mesyert.dll 
mfc42.dll 
mFc42u.dll 
msstkprp.dll 
darice.cub 
logo.cub 
mergemod.dll 
mergemod.cub 
orca.dat 


Destination 

CommonFilesFolder\Microsoft Shared\MSI Tools 
SystemFolder 

SystemFolder 

SystemFolder 

SystemFolder 

ProgramFilesFolder\Orca 
ProgramFilesFolder\Orca 
CommonFilesFolder\Microsoft Shared\MSI Tools 
ProgramFilesFolder\Orca 
ProgramFilesFolder\Orca 


> 


Show: |All Files 


v | Select All Clear All 


2. Select the Applications to be Isolated and then select the Files to Isolate for Selected Application. 


Repeat as necessary. 


3. Click OK. When you return to the Summary Information Panel, verify your settings before isolating. 


InstallShield Software Corporation © 2004 


559 


AdminStudio 5.5 User Guide 10 Isolating Applications 


To modify the default isolation recommendations when using manifests for isolation: 


1. From the Summary Information Panel of the Application Isolation Wizard, click Modify. The Manifest 
and Assembly Design Dialog is displayed. 


Manifest and Assembly Design 


Applications to be Isolated: Assemblies to be added in an Application: 
at Assembly Name 
& Company. Division. Assembly2 Company. Division. Assembly1 


= m) Orca.exe Company. Division. Assembly2 
FA Company. Division Assembly 1 


New ¥ | Delete Select All Clear All 
mrm 


2. If you need to create a new assembly, select the application for which you want to create the assembly, 
click New, and select the assembly type: Private Assembly or Shared Assembly. 


Private Assembly | 


Shared Assembly 


A new assembly is listed under the selected application. 
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3. Select the new assembly then add or remove files in the assembly. 


Manifest and Assembly Design 


Applications to be Isolated: 
a- orca.exe File Name Destination 
Ha Company. Division. Assembly2 
Ia Company. Division. Assembly3 
5-0 orca.exe 
Ia Company. Division. Assembly1 


evalcom.dll CommonFilesFolder\Microsoft Shared\MSI Tools 
msvcrt. dll SystemFolder 

mfc42.dll SystemFolder 

mfc42u.dll SystemFolder 

msstkprp.dll SystemFolder 

darice.cub ProgramFilesFolder\Orca 

logo.cub ProgramFilesFolder\Orca 

mergemod.dll CommonFilesFolder\Microsoft Shared\MSI Tools 
mergemod.cub ProgramFilesFolder\Orca 

orca, dat ProgramFilesFolder\Orca 


| > 


nw | Show: [Al Files y| (Select an Clear Al 


4. Click OK. When you return to the Summary Information panel, verify your settings before isolating. 
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Filtering File Listings when Manually 
Configuring Isolation 


To filter the file listing when manually configuring application isolation using manifests: 
1. In the Manifest and Assembly Design Dialog, select an assembly from the application tree. 


2. Directly below the Files to be added in an assembly window, specify the files displayed from the Show 
filter. 


Manifest and Assembly Design 


Applications to be Isolated: Files to be added in an Assembly: 

=) orca.exe File Name Destination 
a Company. Division. Assembly2 evalcom.dll CommonFilesFolder\ Microsoft Shared\MSI Tools 
Ha Company. Division, Assembly3 mevert dll SystemFolder 


=  orca.exe — mFc42.dll SystemFolder 
Ha Company. Division. Assembly1 mc42u dll SystemFolder 
msstkprp.dll SystemFolder 
darice.cub ProgramFilesFolder\Orca 
logo.cub ProgramFilesFolder\Orca 
mergemod.dll CommonFilesFolder\Microsoft Shared\MSI Tools 
mergemod,cub ProgramFilesFolder\Orca 
orca,dat ProgramFilesFolder\Orca 


g | > 


New v | Show: |All Files Select All Clear All 


All Files 

Dynamic Link Library (*,DLL 

Activex Control (*, OCX) 
Type Library (*,TLB) > 
Object Library (*.OLB — 
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To filter the file listing when manually configuring application isolation using Windows 
Installer isolated components: 


1. In the Isolated Components Dialog, select an application from the application tree. 
2. Directly below the Files to Isolate for Selected Application window, specify the files displayed from the 
Show filter. 


Isolated Components Design 


Applications to be Isolated: Files to Isolate for Selected Application: 


Application File Name Destination 


A) Orca.exe evalcom.dll CommonFilesFolder\Microsoft Shared\MSI Tools 
A Orca.exe msvcrt. dll SystemFolder 
mFc42.dll SystemFolder 
mFc42u.dll SystemFolder 
msstkprp.dll SystemFolder 
mergemod.dll CommonFilesFolder\Microsoft Shared\MSI Tools 


| > 


Dynamic Link Library (*.DLL) ¥ Clear All 


All Files 


Dynamic Link Library (*,DLL 
anes Core 0 
Type Library (*.TLB) s 
Object Library (*,OLB — 
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Servicing Published Shared Assemblies 


Shared assemblies can be serviced (altered) after publishing to update them as necessary. This is accomplished using a 
publisher configuration, which overrides default configurations specified in the manifest. For an exhaustive discussion 
of how to service shared assemblies, refer to the article How To Build and Service Isolated Applications and Side-by- 

Side Assemblies for Windows XP on the Microsoft DevStudio Network Web site (msdn.microsoft.com). 


Application Isolation Wizard Reference 


The Application Isolation Wizard scans Windows Installer packages (.msi) or merge modules (.msm) and isolates 
applications within them. Isolation ensures that applications always use the specific shared and support files with 
which they were installed. This prevents the overwriting of previous versions of shared components, and ensures that 
other applications do not overwrite the versions of shared and support files required by your application. 


Welcome Panel 


The Welcome panel is the first panel displayed when you launch the Application Isolation Wizard. It provides a 
general explanation of application isolation. 


InstallShield Application Isolation Wizard 


Welcome to the Application Isolation 
Wizard 


This wizard will scan a Windows Installer file installation 
package [.msi] or merge module [.msm)] and isolate 
applications within it. 


. 
UI ) What is application isolation? 


Isolation ensures that applications always use the specific 
shared and support files with which they were installed. 
Application Isolation prevents the overwriting of previous 
versions of shared components, and ensures that other 
applications do not overwrite the versions of shared and 
support files required by your application. 


Click Next to proceed to the Windows Installer File Selection Panel. 
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Windows Installer File Selection Panel 


Enter the full path and file name of the Windows Installer package (.msi) or merge module (.msm) that you want the 
Application Isolation Wizard to scan for isolation candidates. Alternately, click Browse to navigate to the file. 


Application Isolation Wizard 
Windows Installer File Selection 


Specify the Windows Installer file on which you want to perform application 
isolation. 


Click Browse to identify the Windows installer package (.msi) or merge module (.msm) that 
will be scanned for application files that can be isolated. 


Windows Installer File: 


v Browse... 


Click Back to return to the Welcome Panel; click Next to proceed to the Isolation Method Panel. 


isolation Method Panel 


Select the application isolation method(s) you want to use for this Windows Installer package or merge module. 


Application Isolation Wizard 


Isolation Method 
Select the method used for application isolation. 


Manifests 
If your installation will be deployed only on Windows XP, use manifests for isolation, 


Use manifests for isolation 


windows Installer Isolated Components 
If your installation will be deployed on Windows 98 SE, Me, and/or Windows 2000, use 
Windows Installer Isolated Components. 


Use Windows Installer isolated components For isolation 


If your installation will be deployed on Windows XP and any of the other supported 
Db operating systems, select both options. (Your installation package size will increase as a 
result.) 
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Make the following selections under Manifests and Windows Installer Isolated Components: 


m If your installation will be deployed only on Windows XP, only select Manifests. 


m If your installation will be deployed on Windows 98 SE, Me, and/or Windows 2000—but not XP—only select 
Windows Installer Isolated Components. 


m If your installation will be deployed on Windows XP and Windows 98 SE, Me, and/or Windows 2000, select both 
options. Your installation package size will increase, but application isolation will work on the appropriate 
operating systems. 


If you use Manifests, click Advanced to display the Advanced Options dialog, from which you can configure manifest 
options and digital signature information. 


Click Back to return to the Windows Installer File Selection Panel; click Next to proceed to the Summary Information 
Panel. 


Summary Information Panel 


From this panel, review a summary of your selections prior to isolation. 


Application Isolation Wizard 


Summary Information 
Verify your selections before starting the application isolation process. 


Package being isolated: Orca.msi 


NOTE: 
The MSI file selected has the schema 100, 
You need a schema of 150 or higher for using the Assembly tables. The Application Isolation — 


Application Assembly Manifests: 
Company. Division. 4ppAssembly2 (1.0.0.1) -- Orca.exe. manifest 
- Local Assemblies 
- Company. Division. 4ssembly2 (1.0.0.1) -- Company. Division. Assembly2,. manifest 
Components 
- Global_VC_CRT.S1DS69E0_8428_11D2_B962_006097C4DE24 


Camnoanente = 


i | > 


Click Modify to make changes to the overall isolation settings. Modify... 


Cea] 


For granular control over the isolation process, click Modify. If you are only using Windows Installer Isolated 
Components as the isolation method, the Isolated Components Design Dialog appears. Otherwise, the Manifest and 
Assembly Design Dialog is displayed. 


Click Back to return to the Isolation Method Panel; click Isolate to isolate the application according to your settings. 
The Application Isolation Progress panel is displayed. 
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Application Isolation Progress Panel 


During application isolation, the progress is displayed on this panel. Information about the applications, assemblies (if 
using manifests as the isolation method), and files is displayed above the progress bar. 


Application Isolation Wizard 


Application Isolation Progress 
The Application Isolation Wizard is isolating components. 


Isolating components. Please wait... 
Isolating file 'mfc42.dll' for ‘Orca.exe! 


Í Cancel | 


Upon isolation completion (or failure), the Completing the Application Isolation Wizard Panel is displayed. 


Completing the Application Isolation Wizard Panel 


The final panel in the Application Isolation Wizard provides feedback on whether the Application Isolation Wizard 
was successful. 


InstallShield Application Isolation Wizard 


Completing the Application Isolation Wizard 


You have successfully completed the Application Isolation 
Wizard. 


The applications in the following file have been isolated and 
written to a new output package. 


Original Package: 
C:\AdminStudio Shared\Orca.msi 


Output Package: 
C:\AdminStudio Shared\Orea_Isolated2. msi 


Click Finish to close this wizard. 


C a% el 


InstallShield Software Corporation © 2004 567 


AdminStudio 5.5 User Guide 10 Isolating Applications 


If the Application Isolation Wizard was successful, the names and locations of the original and output packages are 
provided. If the Wizard was not successful, this panel informs you that the selected components could not be isolated. 


Advanced Options Dialog 


The Advanced Options dialog, available from the Isolation Method and Ready to Isolate panels of the Application 
Isolation Wizard™, allows you to configure assembly types, naming conventions, and digital signature options. These 
are accessible from the Manifest Options and Digital Signature tabs. 


Once you have finished configuring advanced options, click OK to save your changes, or Cancel to close the dialog 
without saving your modifications. When the dialog closes, you are returned to the panel where you clicked Advanced. 


Manifest Options Tab 


The Manifest Options tab, available in the Advanced Options Dialog, allows you to configure several settings 
associated with manifests. 


Advanced Options 


Manifest Options | Digital Signature | 


Assembly Type 
© Create private side-by-side assemblies in the application folder 
© Create shared side-by-side assemblies in WinSxS directory 


i Manifests for shared assemblies must be digitally signed. Click 
the Digital Signature tab to specify certificate details. 


Assembly Naming Conventions 
Company: 


| Company 


Division: 


| Division 


i Specify Company and Division to standardize how assembly 
W names are constructed. Assembly names will be specified in 
the form "Company. Division.Assembly"'. 


Create new component for each assembly 
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Option 


Description 


Assembly Type 


The Assembly Type option allows you to select whether the Application Isolation Wizard™ 
uses private side-by-side assemblies in the application folder or shared side-by-side 
assemblies in the WinSxS folder. This is the default setting; if you want to use both 
assembly types, you need to manually configure assemblies from the Modify Isolation 
Settings dialog. 


N j 


Manifests for shared assemblies must be digitally signed. This can be done in the Digital 
Signature tab. 


Assembly Naming 
Conventions 


Specify your company and division information to standardize how assembly names are 
constructed. Assembly names are then specified in the form "Company.Division. Assembly" 
by default. 


Create a new 
component for each 
assembly 


Select this option if you want to create a new component for each assembly created during 
isolation. 


This check box applies to all assemblies created. Individual assemblies can be configured 
from the Assembly Properties Dialog on a per-assembly basis. 


If you are creating assemblies for applications files within multiple components, this option 
must be selected for successful application isolation. 


If you are planning to deploy this isolated package to operating systems prior to Windows 
XP, always check this box. 
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Digital Signature Tab 


The Digital Signature tab, available in the Advanced Options Dialog, allows you to configure the certificate 
information required when using shared assemblies. This required digital signature provides an extra layer of 
protection, allowing you to obtain information about the company who created a global assembly. 


Advanced Options 


| Manifest Options | Digital Signature 


Certificates are required for signing shared assemblies. 


Certificate Details 
Certificate File: 


Code Signing Technology 
© Credentials 
SPC File: 


Browse... 
| Browse... 


© Certificate Name in the store 


Em e r 


The Application Isolation Wizard™ uses timestamping when signing global assemblies. Consequently, you must have 
an Internet connection on the computer when you create a global assembly. 
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You must configure the following options when signing these assemblies: 


Option Description 


Certificate Details Provide the name and location of the certificate file you are using to sign assemblies. A 
digital certificate identifies you and/or your company to end users and assures them the 
data they are about to receive has not been altered. You can also navigate to the file by 
clicking the Browse button. 


Code Signing Select the type of code signing technology you want to use for the digital signature. You 
Technology can use one of the following technologies: 


a Credentials —If you select this option for the code signing technology, you must 
supply the name and location of both your software publishing credentials (.spc) file 
and the name and location of the private key file (.pvk). You can enter these names 
and locations in the appropriate fields, click Browse and navigate to them. In order to 
receive a software publishing credentials and a private key, you must supply a 
certification authority with specific information about your company and software. 


= Certificate Name in the store—As an alternative to providing .spc and .pvk files, 
you can specify the certificate name as it appears in the certificate store. The certificate 
store is a central repository for certificate files so they can be reused for different 
purposes as necessary. 


A 2048-bit key is required to sign a Windows XP assembly/manifest being installed to the WinSxS folder. 
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Manifest and Assembly Design Dialog 


If you are using manifests to isolate your application, either alone or in conjunction with Windows Installer isolated 
components, the Manifest and Assembly design dialog is displayed when you click Modify from the Summary 
Information panel. 


Manifest and Assembly Design 


Applications to be Isolated: Assemblies to be added in an Application: 


s0 | Assembly Name 
@ Company. Division Assembly2 C Company. Division, Assembly 1 


= m) Orca.exe Company. Division, Assembly2 
Z Company. Division. Assembly 1 


New ¥ | elete Select All Clear All 
[exe] Cre 


When you first display this dialog, the settings the Application Isolation Wizard™ recommends for this package are 
displayed. By default, only executables that will be installed in the SystemFolder will be selected for isolation. You can 
select an application contained in the Windows Installer or merge module and create a new private or shared assembly 
for that application. You can then select the files to isolate for the selected application. A filter at the bottom of the 
dialog allows you to restrict the file types visible. 


Click Properties to display the Application Manifest Properties Dialog. From this dialog, you can configure the 
naming convention for assemblies and manifests, and specify whether you want manifests placed into separate 
components. 


When you have finished performing manual configuration, click OK to return to the Summary Information panel. 
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Isolated Components Design Dialog 


If you are only using Windows Installer isolated components to isolate the application, this dialog is displayed when 
you click Modify from the Summary Information panel. 


Isolated Components Design 


Applications to be Isolated: Files to Isolate for Selected Application: 


Application | File Name Destination 

k’) orcaexe OOOO O O | evalcom.dll CommonFilesFolder\Microsoft Shared\MSI Tools 
| Bd Orca.exe mesvecrt. dll SystemFolder 
| mc42.dll SystemFolder 
mfc42u.dll SystemFolder 
msstkprp.dll SystemFolder 
darice.cub ProgramFilesFolder\Orca 
logo.cub ProgramFilesFolder\Orca 
mergemod.dll CommonFilesFolder\ Microsoft Shared\MSI Tools 
mergemod.cub ProgramFilesFolder\Orca 
orca.dat ProgramFilesFolder\Orca 


> 


Show: | All Files Mi Select All Clear All 


When you first display this dialog, the settings the Application Isolation Wizard™ recommends for this package are 
displayed. By default, only libraries that will be installed in the SystemFolder will be selected for isolation. You can 
select an application contained in the Windows Installer or merge module, and then select the files to isolate for the 
selected application. A filter at the bottom of the dialog allows you to restrict the file types visible. 


When you have finished performing manual configuration, click OK to return to the Summary Information panel. 
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Assembly Properties Dialog 


The Assembly Properties dialog displays information about the manifest and assembly, and can be launched from the 
Manifest and Assembly Design dialog by selecting an assembly and clicking Properties. 


Assembly Properties 


Manifest Details 


Filename: 


Assembly Identity 


Name: Company. Division. Assembly 1 


version: | 1.0.0.1 


Assembly Type 
© Private 
O Shared 


Create new component 


The following groups contain configurable options: 


Group Description 


Manifest Details In the Manifest Details group, you can view the file name for the manifest. It is structured in 
the form "Company. Division.Assembly.manifest" by default. 


Assembly Identity The Assembly Identity group contains fields for the Assembly Name and Version. When 
you change the assembly name, the manifest file name changes. 


Assembly Type This group allows you to select whether the current assembly is private or shared. If it is 
shared, you must configure digital signature information in the Advanced Options dialog. 


Create new component Select this option if you want to create a new component for this assembly. 


If this assembly contains files that originate from multiple components, this option must be 
selected for successful application isolation. 


If you are planning to deploy this isolated package to operating systems prior to Windows 
XP, always check this box. 


This check box applies only fo this assembly. Global settings for assemblies can be 
configured from the Manifest Options tab of the Advanced Options Dialog. 
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Application Manifest Properties Dialog 


The Application Manifest Properties dialog displays information about the manifest and assembly, and can be 
launched from the Manifest and Assembly Design dialog by selecting an application and clicking Properties. 


Application Manifest Properties 


Manifest Details 


a eEEi-teeorca.exe.manirest 


Assembly Identity 


Name: | Company. Division. AppAssembly2 


Version: | 1.0.0.1 


The following groups contain configurable options: 


Group Description 


Manifest Details In the Manifest Details group, you can view the file name for the manifest. It is structured in 
the form "Company. Division.Assembly.manifest" by default. 


Assembly Identity The Assembly Identity group contains fields for the Assembly Name and Version. When 
you change the assembly name, the manifest file name changes. 


Command-Line Options 


The Application Isolation Wizard can also be run from the command line. You can specify the following options 
when running the AIW.exe executable from the command line: 


Option Description 

= Displays commandline help for the Application Isolation Wizard. 

-version Displays the version of AdminStudio. 

-i <configuration file> Allows you to specify a configuration file for Application Isolation Wizard settings. The 


default file, AIWConfig.ini, is located in <AdminStudio Directory>\Common and can 
be used as a model. This parameter is optional. 


-p <package name> The name and location of the package or merge module which includes applications 
you want to isolate. This parameter is mandatory. 
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When using the command-line options for the Application Isolation Wizard, you can specify an INI file for 
configuration using the -i parameter. This file should take the following format: 


[IsolationMethods] 
Mani fests=1 
IsolatedComponents=1 


[DigitalSignature] 
CertificateFile= 
SPCFi le= 

PVKFi le= 
CertificateName= 
TimeStampAssemblies= 


[Manifest] 
AssemblyType=0 
Company="Company" 
Division="Division" 
NewComponents=0 


Each configuration corresponds to a user interface setting in the Application Isolation Wizard, as described below: 


INI File UI Setting Explanation 

Manifests Use manifests for isolation Set this value to 1 to use manifests. Manifests only work 
option on Isolation Method with Windows XP. 
panel 

IsolatedComponents Use Windows Installer isolated Set this value to 1 to use Windows Installer isolated 
components for isolation on components. 
Isolation Method panel 

CertificateFile Certificate File field on the Provide the name and location of the CER file. 
Digital Signature tab of the 
Advanced Options dialog 

SPCFile SPC File field on the Digital Provide the name and location of the SPC file 
Signature tab of the Advanced 
Options dialog 

PVKFile PVK File field on the Digital Provide the name and location of the private key. 
Signature tab of the Advanced 
Options dialog 

CertificateName Certificate Name in the store Provide the name of the certificate from the certificate store. 
field on the Digital Signature 
tab of the Advanced Options 
dialog 
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INI File UI Setting Explanation 


TimeStampAssemblies No corresponding UI setting Set this value to O to disable timestamping during shared 
assembly creation; set it to 1 to enable timestamping. By 
default, the Application Isolation Wizard uses 
timestamping if this value is not configured. 


AssemblyType Assembly Type on the Manifest Set this value to O to use private assemblies; set the value 
Options tab of the Advanced to 1 to use shared assemblies. 
Options dialog 


Company Company field on the Manifest Put the name of your company in quotes. 
Options tab of the Advanced 
Options dialog 


Division Division field on the Manifest Put the name of your division in quotes. 
Options tab of the Advanced 
Options dialog 


NewComponents Create new component option Set the value to 1 to create a new component for each 
in Manifest Options tab of manifest. 
Advanced Options dialog 


Manifest Examples 


Following are examples of both an application manifest and an assembly manifest: 


Application Manifest Example 


<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVversion="1.0"> 
<assemblyIdentity type="win32" name="Instal1lShield.Development.AppAssembly4" version="1.0.0.1" 
processorArchitecture="x86" /> 

<description>This manifest was generated by the Application Isolation wizard</description> 
- <dependency> 

- <dependentAssemb1y> 

<assemblyIdentity type="win32" name="Instal1lShield.Development.LocalAssembly1" 
version="1.0.0.1" processorArchitecture="x86" /> 
</dependentAssemb 1 y> 

</dependency> 

</assembly> 
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Assembly Manifest Example 


<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0"> 
<assemblyIdentity type="win32" name="Instal1lShield.Development.LocalAssembly1" 
version="1.0.0.1" processorArchitecture="x86" /> 
<file name="IsCommonServices.d11"> 
- <comClass description="CabinetBuilder Class" clsid="{8D3FE200-DA96-11D3-BEE7-00105A996B4E}" 
progid="ISHerculescommonServices.CabinetBuilder.1" threadingModel="Apartment" 
tlbid="{2491C036-D5B0-11D3-BEE5-00105A996B4E}"> 
<progid>ISHerculesCommonServices.CabinetBui Ilder</progid> 
</comClass> 
- <comClass description="Cabinet Class" clsid="{3C35E807-C92D-11D3-BEDF-00105A996B4E}" 
progid="ISHerculescommonServices.CabinetExtractor.1" threadingModel="Apartment" 
tlbid="{2491C036-D5B0-11D3-BEE5-00105A996B4E}"> 
<progid>ISHerculesCommonServices.CabinetExtractor</progid> 
</comClass> 
- <comClass description="InstallShield Common Services Registry object" 
clsid="{3032B526-2C3D-11D4-AB2C-00C04F09719A}" progid="ISHerculesCommonServices.Registry.1" 
threadingModel="Apartment" tlbid="{2491C036-D5B0-11D3-BEE5-00105A996B4E}"> 
<progid>ISHerculesCommonServices.Registry</progid> 
</comClass> 
</file> 
</assembly> 
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ra 


QualityMonitor is included with AdminStudio Professional Edition. 


Prior to deploying a Windows Installer—based application, typically you need to test it in the targeted deployment 
environment to ensure the application works as expected. However, it is often not feasible (or possible) to test each 
piece of an application's functionality, due to the complexity of the application and/or its interface. Behind the scenes, 
there may be dozens or hundreds of attempts to access files, registry keys, or services; errors may only become 
apparent in rare and isolated circumstances. 


One major source of failure is when the target environment is restricted in some way, such as in a locked-down 
environment. In this case, there may be prohibitions on certain COM activation or registry access, which ultimately 
prevents an application from working correctly. 


QualityMonitor allows you to run a series of built-in tests to installed Windows Installer—based products, helping to 
ensure they run correctly. When failures occur, QualityMonitor can help identify where problems exist, and ultimately 
direct you to the solution. 


InstallShield Software Corporation © 2004 581 


AdminStudio 5.5 User Guide 11 Ensuring Package Quality 


Opening Existing QualityMonitor Project 
Files 


To open an existing QualityMonitor project file (.iqm): 


1. Launch QualityMonitor. 
2. Select Open from the File menu. The Open QualityMonitor Project Dialog appears. 


Open QualityMonitor Project 


| &| 


© Select an application that is installed on this machine from the following list. This list shows 
installed products based on Windows Installer (MSI) technology. 


AdminStudio 5 Evaluation Guide 
WB InstallShield AdminStudio 


(installshield Developer 

jf installshield Express 

iB microsoft «NET Framework (English) 
j Microsoft NET Framework 1.1 

BB Microsoft Office xP Professional 


MicracoFr Windmee Tonal Viamar 


OK | Cancel | More Info >> 


3. From the Open QualityMonitor Project Dialog, select the Open QualityMonitor project (.iqm) file 
option. 


4. Enter or browse to the file you want to open. 


5. Click OK. 
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Creating New QualityMonitor Project 
Files 


To create a new QualityMonitor project file (.iqm): 


1. Launch QualityMonitor. 


2. Select Open from the File menu. The Open QualityMonitor Project Dialog appears. 


Open QualityMonitor Project 


© Select an application that is installed on this machine from the Following list. This list shows 
installed products based on Windows Installer (MSI) technology. 


AdminStudio 5 Evaluation Guide 
B InstallShield AdminStudio 


(installshield Developer 

{Bl nstallshield Express 

{microsoft «NET Framework (English) 
(microsoft «NET Framework 1.1 

i Microsoft Office XP Professional 


A Micracetr \Mindeuste Tniwnsl Wiener 


OK | Cancel | More Info >> 


3. On the Open QualityMonitor Project Dialog, select to use an application on the current machine. 


4. Select an application from the available applications list. 


5. Click OK. A new QualityMonitor project for the selected application is opened, and the Product 
Information View is displayed. 
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Working with Test Cases 


The primary purpose of QualityMonitor is to serve as a diagnostic tool when applications fail to function correctly in 
deployment environments. This is accomplished primarily through running Test Cases and individual Test Items, and 
evaluating the results. Topics in this section cover the most common tasks you may perform when working with Test 


Cases. 


Running Individual Test liems 


Se 


To run an individual Test Item: 


Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


Select the appropriate Test Case containing the Test ltem you want to run. 


Right-click on the Test Item you want to execute and select Run. 


Test Items a 

View these test items: |72 all >| Run ail | Run Reset Results | 
Status | Class 1D File Name s 
Pe ) {F9043C85-F6F2-1014- ASCO -08002B2F49FB} Microsoft Common Dialog Control, version ule 0 \WINDO WSIS ystem32\comdigs2. ocx 


Property Pag ject co x 
‘AWINDOWStSystema2toleaut32, dil 


Select All Ctrl +4 


) {B196B286- BAB4-1014-B69 


) {0BE35203-8F91-11CE- O T C\WINDOWS\System32\oleaut32. dll = 

g |) {46763EE0-CAB2-11CE-8Cz J C:\WINDOWS\System32\oleaut32. dll 7 
ng {0BE35204-8F91-11CE-9DE 56t Status C:\WINDOWS\System32\oleaut32. dll 
ending {00020421-0000-0000-C00 - ae C:\WINDOWS\System32\oleaut32. dll 
Pending 400020422-0000-0000-cop, _Test Item Information... | C:\WINDOWS\System324oleaut32.dll 

Pending {00020423-0000-0000-C000-000000000046} PSTypeLib C:\WINDOWS\System32\oleaut32. dll a 
Pending {00020425-0000-0000-C000-000000000046}  PSTypeComp C:\WINDOWS|System32\oleaut32. dll 
Pending {0000002F-0000-0000-C000-000000000046}  CLSID_RecordInfo C:\WINDOWS\System32\oleaut32. dll 


Depending on whether the Test Item is automatic or requires opening or launching files, you may need 
to perform some manual tasks prior to results being returned. 
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Running Multiple Test Items 


ee 


To run multiple Test Items: 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the appropriate Test Case containing the Test Items you want to run. 


3. Select the Test Items you want to run. Multiple selection is supported using the Shift and Ctrl keys. 


Test Items 
View these test items: | Pa all x] Run Ail Run Reset Results | 
Status | Class 1D [Description | FileName a 


Pending 4{F9043C85-F6F2-1014-43C9-08002B2F49FB} Microsoft Common Dialog Control, version 6.0 = C:\WINDOWS\System32\comdlg32.ocx 


F 51}  CLSID_S5tdPict C\WINDOWS\System32\oleaut32. dll 
Pending {00020421-0000-0000-C000-000000000046} = PSEnumiariant C:\WINDOWS\System32\oleaut32. dil 
Pending 4{00020422-0000-0000-C000-000000000046} = PSTypelnfo C:\WINDOWS\System32\oleaut32. dll 
Pending {00020423-0000-0000-C000-000000000046} = PSTypeLib C\WINDOWS\System32\oleaut32. dll 


4. Torun only the selected Test Items, click Run. To run all Test Items, click Run All. 


Depending on whether the Test Items are automatic or require opening or launching files, you may need to perform 
some manual tasks prior to results being returned. 


Adding Test item Comments 


To add comments to an individual Test Item: 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case containing the Test ltem to which you want to add comments. 
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3. Right-click on the Test Item and select Test Item Information. The Test Item Information Dialog appears. 


E Test Item Information 


Test Item: | c:\program Files\symantec_client_security\symantec antivirus\¢ 


Status: E Passed -| 


Comments: 


Test Details: 


4. Enter comments into the Comments field. 


5. When finished, click OK. 


Adding Test Case Comments 


You can add comments associated with an entire Test Case. 


(g> 


Bi 
To add comments to a Test Case: 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case to which you want to add comments. 


3. Enter comments as necessary in the Comments area. 


H F Class IDs 
4 ¢ Ss 
Test Case Status Test Case Progress Comments 
Choose a status for the entire test Total test items: 51 These tests were run on January 
case 15, 2003 by Jason Williams, 
v| Passed: 2 (3%) 
(@ Pending ae 
X| Failed: 0 (0%) 
C Passed Pending: 49 (97% 
C Fae es 
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Viewing Test item Details 


When a Test Item is failed, you can view details about it, including the error message associated with it. This 


information is displayed on the Test Item Information dialog, along with the Test Item name, status, and any 
comments that have been entered. 


A 
Véi 


To view Test Case details: 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case containing the Test Item for which you want to view test details. 


3. Right-click on the appropriate Test Item and select Test Item Information. The Test ltem Information 
Dialog appears, and Test Case details are listed in the Test Details text box. 


E Test Item Information 


Test Item: | {00020423-0000-0000-C000-000000000046} 


Status: X] Failed x | 


Comments: 


Test Details: Wo such interface supported 


OK | Cancel íi 


4. When finished viewing test details, click OK to close the dialog. 


Clearing Test Case Results 


7 N 
2 


i) 


To clear Test Case results (all Test Items) from a previous Test Case execution: 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case you want to clear from the View List. 
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3. Click the Reset Results button. 


Reset Results | 


@)- 


When you click Reset Results, the status of all Test Items is reset. To reset the status of one individual Test ltem, select that 
Test Item and select Set Status > Pending from the context menu. See Manually Setting Test Item Status. 


Manually Setting Test Case Status 


Depending on your business practices and standards, you may want to override the status of a Test Case in the View 


List from its current state. In most cases, this will be setting a Test Case which QualityMonitor has marked as failed 
(because one or more individual Test Items have failed) to passed. 


or 
8, 
To manually set the Test Case status: 


Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 
Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the appropriate Test Case from the View List. 


In the Test Case Status area, change the status to the desired state by selecting Pending, Passed, or 
Failed. 


ate Class IDs 


‘ COM Class IDs test case details 


Test Case Status 


Choose a status For the entire test 
case 


© Pending 


@ Passed va 


C Failed 
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ee 


To manually set the status of an individual Test Item: 


11 Ensuring Package Quality 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 


Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case containing the Test Item from the View List. 


3. Right-click on the Test Item, point to Set Status, and select the status from the Set Status submenu. 


penang {WUU2ZU4+2 1-UUUU-UUUU-LUUU-UUUUUUUUUUto¢ = Po numyarianc 
Pending {00020422-0000-0000-C000-000000000046} PSTypelnfo 
PSTypeLib 


g Select All Ctrl + & 
9 {BDD1F04B-858B-11D1-B164-00C0F0283 


) {2C247F23-8591-11D1-B164-00C0F0283628} Microsoft ImageList Control, versit 
{8E386743-8586-11D1-B164-00C0F0283628}+ Microsoft StatusBar Control, version 6.0 


Filtering Test Case Data 


To filter the displayed data in a Test Case: 


6.0 

J {7629CFA4-3FE5-1018-A3C9-08002B2F4) Run FS = Ohiect 
{C74190B6-8589-11D1-B164-00COF0283 SREE J Pending 
{1EFB6596-857C-11D1-B164-00COF0283 
{66833FE6-8583-11D1-B164-00COFO283 Test Item Information... ailed 


1. Open one of the Test Views under Deployment Tests (Class IDs, File Associations, Help Files, Prog IDs, 


Services, Shortcuts, Type Libraries, ODBC Data Sources, or ODBC Drivers). 


2. Select the Test Case containing the data you want to filter from the View List. 


3. From the View these test items list, select the filter you want to apply to the data: All, Passed, Failed, or 


Pending. 


Test Items 


view these test items: |72 all M 
YA all 
v! Passed |= 
Pending {F9043C85-F6F2-1q §@ —PF49FB} Microsoft Common Dia 
Pending {7629CFA42-3FE5-14 a PF49FB} Common Dialog Open 
Pending 4{B196B286-B4B4-10TS-BB9C-D0a800341D07} PSFactoryBuffer 
Pending 4{0BE35203-8F91-11CE-9DE3-0044004BB851} CLSID_StdFont 
Pending 4{46763EE0-CAB2-11CE-8C20-00440051E5D4} Obsolete Font 


The view is automatically updated based on the selected filter. 
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Deployment Testing 


Deployment tests are performed against the installed product, ensuring that the product has been installed correctly 
and all key functionality works in the installed environment. Test Cases in this area are primarily designed to identify 
whether the application fails to work properly due to permission settings on the registry or individual files. 


Gulag: B 
= A Crystal Reports 
=) Test Cycle Summary 
= ... Tests 

leĝ Class IDs 
C] x] File Associations 
2 Help Files 
i] Prog IDs 
E Shortcuts 
Ws Type Libraries 
G] ODBC Drivers 
O Și ODBC Data Sources 
© Lockdown and Runtime Tests 
@ User-Defined Tests 


Some of the primary areas checked are: 


Area Description 


COM Data Ensure all COM objects can be instantiated programmatically. This includes Class IDs, 
Prog IDs, and Type Libraries. COM data is tested silently, returning results in the Test Case 
Progress area and the queue. 


File Associations Ensure all file extensions have been installed and associated correctly. This involves 
launching a file with this extension, and determining if the correct application was used. 


Help Files Ensure help files are installed and can be launched correctly. 

Shortcuts Ensure each shortcut is installed and successfully launches the shortcut target. 

ODBC Data Sources Verify ODBC data sources. 

ODBC Drivers Verify ODBC drivers. 

Services Ensure all NT Services have been installed correctly. This is done by opening the Services 


Manager to determine the Service exists on the target machine. 
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Automatically Running All Deployment Tests 
Silently 


You can choose to run all deployment tests silently (without prompting for user input) using either the Interface or 
the command line. 


From the Interface 


To run all deployment tests silently from the Interface, do one of the following: 


m Select the Deployment Tests root node and then click the Execute All Deployment Tests button, displayed on the 
right side of the Deployment Tests View. 


Crystal Reports - InstallShield QualityMonitor [C:\AdminStudio Shared\Crystal Reports.iqm] 
File View Test Case Execute Tools Help 
|S hH|&|! ae 


Crystal Reports E] Deployment Tests 
| Test Cycle Summary | EY Lists all the Deployment tests 


Class IDs 
m Ẹ File Associations Deployment Tests Summary 


Help Files 
—] y) Prog IDs 
L E Shortcuts 
E» Type Libraries Totaltest cases: 8 


rm : 
-J &] ODBC Drivers v| Passed: 0 (0%) 


C $A ODBC Data Sources wae E 
E Lockdown and Runtime Tests [X] Failed: 0 (0%) Execute All Deployment Tests | 


8 User-Defined Tests Pending: 8 (100% 


Deployment Tests Progress 


Deployment Tests Items 


ofa 51 Class IDs 

|x] 1File Associations 
(@ 13 Help Files 

p] 29 Prog IDs 

E 3 Shortcuts 

Wy 1 Type Libraries 

g] ZODBC Drivers 

i 40DBC Data Sources 
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m Select the Deployment Tests root node and then select Execute All Deployment Tests from the context menu. 


E Crystal Reports 
a Test Cycle Summary 


classid 


X) File Ass | 
Help File 
Execute All Deployment tests 


J] Prog ID E a 
E Shortcuts 

JM. Type Libraries 

CG] ODBC Drivers 

§ ODBC Data Sources 
© Lockdown and Runtime Tests 
ĝ User-Defined Tests 


Em Select All Deployment Tests from the Execute menu. 
m Click the Execute All Deployment Tests toolbar button: 


5 


pos 


When you select one of these options, a dialog with a progress bar and an option to cancel will be displayed. 


From the Command Line 


You can also run all deployment tests silently by entering a command in the command line. See Running 
QualityMonitor from the Command Line for more information. 
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To check Class ID functionality: 


1. With QualityMonitor launched and the application you are testing open, select Class IDs from the View 
List. The Class IDs View opens. 


+ Paint Shop Pro 7 Anniversary Edition - InstallShield QualityMonitor 


File View TestCase Execute Tools Help 


|e hw! a Y 

5- Paint Shop Pro 7 Anniversary Edition 

2) Test Cycle Summary 
Deployment Tests 

C |x) File Associations 

Help Files 

C vy) Prog IDs 

OE Shortcuts 

CJM Type Libraries 

© Lockdown and Runtime Tests 

@ User-Defined Tests 


Class IDs 


COM Class IDs test case details 


r Test Case Status 


Choose a status for the entire test 
case 


@ Pending 


C Passed 


r Test Case Progress ———_) 


Total test items: 


v| Passed: 
[X] Failed: 


Pending: 


© Failed 


Last Run At: 


Test Items 


Comments —————— 
27 

0 (0%) 

0 (0%) 


View these test items: [Fà All z] Run All | Run | 


Reset Results 


EA Description FileName 


Pending 
Pending 


Pending 


{2CF184C6-8253-11D3-9FD6-00500403FE36} 
{336CESAF-8557-11D3-9FD6-00500403FE36} 
{00020421 -0000-0000-co000-000000000046} 


g {00020422-0000-0000-Cc000-000000000046} 


HotLink Property Page 
HotLink Control 
PSEnum¥ariant 
PSTypelnfo 


C:\Program Files\Jasc Software 
C:\Program Files\Jasc Software 
CA\WINDOWS\System32\oleaul 


ding {00020425-0000-0000-C000-000000000046} 


{00020423-0000-0000-Cco000-000000000046} 
3 {00020424-0000-0000-C000-000000000046} 


PSTypeLib 
PSOAlInterface 


PSTypeComp 


C:\WINDOWS\System32\oleaul 

CAWINDOWS\System32\oleaul 

C:\WINDOWS\System32\oleaul 

C:AWINDOWS\System32\oleaul v 
| E 


C nm 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. 


3. When testing is finished, results are recorded in the Test Case Progress area. 


When a Test Item is failed, you can view details about it, including the error message associated with it on the 
Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 


from the context menu. 
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Checking File Associations 


To test file associations: 


1. With QualityMonitor launched and the application you are testing open, select File Associations from 
the View List. The File Associations View opens. 


+ Paint Shop Pro 7 Anniversary Edition - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 

r ] ] 

|S kh A ay 

=) Paint Shop Pro ? Anniversary Edition File Associations 


(| Test Cycle Summary Re File Associations test case details 
=| Deployment Tests 


LJ oy Class IDs r Test Case Status Test Case Progress ——_ -Comments 


H 3 File Associations Choose a status for the entire test 


Total test items: 7 


Help Files case 

Prog IDs Gipand vV! Passed: 0 (0%) 
€ Pending x 

o ae X] Failed: o (0%) 

@ Lockdown and Runtime Tests 

@ User-Defined Tests 


© Passed 


Pending: (100 


© Failed 


Last Run At: 


Test Items 


View these test items: |74 All x] Run All | Run Reset Results 


| status | File Extension | Progro | Defaut verb 


AnimationShop3. Animation open 
AnimationShop3.WorkSpaceFile open 
PSP7. Image open 
PSP7. WorkSpace open 
PSP7.BrowserFile open 
PSP7.MultilmagePrint open 
JMC.Document open 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. The Test Progress Dialog opens. 


Test Progress 


Testing File Associations: 1 of 1 - "wsa"... 


Click Run to execute the current test item, 


3. When the Test Progress Dialog opens, click Run to exercise the file association. 
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4. From the resulting Open dialog, browse to a file with the appropriate extension and click Open. The 


file is launched with its associated application. Following the application launch, the Test Result Dialog 
appears. 


E Test Result 


p Did "wsa" Work Properly? 


Comment: 


5. Click Yes or No depending on whether the file launched with the expected program. You can also 
enter comments in the Comment field on this dialog. 


Checking Help Files 


To test help file functionality: 


1. With QualityMonitor launched and the application you are testing open, select Help Files from the 
View List. The Help Files View appears: 


Microsoft Office XP Professional - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 


|© hS! 3 9 
| 5} Microsoft Office XP Professional 


Help Files 
=) Test Cycle Summary E Help Files test case details 
= Deployment Tests 


Ei Class IDs Test Case Status Test Case Progress 
X) File Associations 
LJ Vv] Prog IDs 


r Comments 


| 
Choose a status for the entire test Total test items: 21 | 
case | 

| 


Passed; 0 (0%) 


v 

@ Pending 
= Sake ] Failed: 0 (0%) 
o p=] ODBC Data Sources C Passed Pending: (100 
© Lockdown and Runtime Tests 


© Failed 


ĝ User-Defined Tests 


Last Run At: 


Test Items 


View these test items: All x] Run all | Run | Reset Results | 


jing c:\program files\microsoft office\office10\cgmimp32.hip 
c:\program files\microsoft office\office10\1033\grtip10. hip 
c:\program files\microsoft office\office10\1033\msqry32. hip 
9 c:\program files\microsoft office\office10\1033\actip10.hip 


eilmennwam Filaclenmman Filaclmicunenth chavadionanchak uinuearlenanuions: ble 
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2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. The Test Progress Dialog opens. 


Test Progress 


Testing File Associations: 1 of 1 - "wsa"... 


Click Run to execute the current test item, 


3. When the Test Progress Dialog opens, click Run to launch the help file. Following an attempt to launch 
the shortcut, the Test Result Dialog appears. 


E Test Result 


p Did "wsa" Work Properly? 
. 


Comment: | 


4. Click Yes or No depending on whether the help file launched correctly. You can also enter comments in 
the Comment field on this dialog. 
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Checking Prog IDs 


To check Prog ID functionality: 


1. With QualityMonitor launched and the application you are testing open, select Prog IDs from the View 
List. The Prog IDs View opens. 


PackageForTheWeb 4 - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 


! a 9 

PackageForTheweb 4 Prog IDs 

=) Test Cycle Summary Vv Prog IDs test case details 
Deployment Tests 


C aĝ Class IDs Test Case Status 

J x] File Associations Choose a status For the entire test Total test items: 3 
AREN = 

] Shortcuts 


v| Passed: 0 (0%) 
brasi @ Pending 
MN Type Libraries X] Failed: 0 (0%) 
© Lockdown and Runtime Te GPad 
8 User-Defined Tests = 


Test Case Progress Comments 


Pending: 3 (100%) 


C Failed 


Last Run At: 


Test Items 


view these test items: |72 All -] Run ll | Run | Reset Results | 


[status [Progip [Description [FileName Class 1D 
Pending PFWServer.PFWFile, 1 PFWFile Class C:\Program Files\InstallShield\PackageForThewWeb 4\PFWServer.dll {032a i 
Pending PackageForTheWeb. Project. File C:\Program Files\InstallShield\PackageForThewWeb 4\prtwwiz.exe 

Pending PFWServer.PFWFile PFWFile Class C:\Program Files\InstallShield\PackageForTheWeb 4\PFWServer dll 


si 


vv 


[_ hal 4 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. 


3. When testing is finished, results are recorded in the Test Case Progress area. 


When a Test Item is failed, you can view details about it, including the error message associated with it on the 


Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 
from the context menu. 
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Checking Services 


To check Service functionality: 


1. With QualityMonitor launched and the application you are testing open, select Services from the View 
List. The Services View opens. 


Symantec AntiVirus Client - InstallShield QualityMonitor [C:\AdminStudio Shared\Symantec AntiVirus Client.iqm] 


Symantec Antivirus Client 
=) Test Cycle Summary 
=| jf Deployment Tests 
Class IDs m Test Case Status + __ -- Test Case Progress -Comments —————————————— 


LIEF Help Files Choose a status for the entire test Total test items: 3 
Prog IDs case 


vV Passed: 0 (0%) 
J] BY Shortcuts @ Pending | 6a Failed: 0 (0%) 
W Type Libraries = i is 
@ Lockdown and Runtime Tests 


© Passed | 


Pending: 3 (100 


| 
A O Fate A 


Last Run At: 


Test Items 


View these test items: | Fa all x] Run All | Run | Reset Results | 


Pending Symantec Antivirus Client 
Pending NAVAPEL 
Pending DefWatch 


si 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. 


3. When testing is finished, results are recorded in the Test Case Progress area. 


When a Test Item is failed, you can view details about it, including the error message associated with it on the 
Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 
from the context menu. 
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Checking Shortcuts 


Shortcut checking involves ensuring each shortcut is installed and can be successfully launched. 


laks 


To check shortcuts: 
1. With QualityMonitor launched and the application you are testing open, select Shortcuts from the View 


List. The Shortcuts View opens. 


PackageForTheWeb 4 - InstallShield QualityMonitor 
File view Test Case Execute Tools Help 


PackageForTheWeb 4 a Shortcuts 
5 Test Cycle Summary l 


Shortcuts test case details 


=| jf Deployment Tests 
O og Class IDs Test Case Status — 


= P File Associations Choose a status for the entire test 


f Test Case Progress — - Comments 
Prog ID | | Totaltest items: 1 
rog IDS case | 
~ E i : 1 (100%) 
CIM Type Libraries © Pending : TR 
fo 
§@ Lockdown and Runtime Te 
& User-Defined Tests 


@ Passed 


Pending: 0 (0% 


C Failed 
L 
Last Run At: 07-14-2003 02:39:08 PM 
Test Items 
view these test items: [aa 


Passed PackageForTheweb 4 C:\Start Menu\Programs\InstallShield\PackageForTheWeb 4.Ink 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. The Test Progress Dialog opens. 


Test Progress 


Testing File Associations: 1 of 1 - "wsa"... 


Click Run to execute the current test item, 


A 
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3. On the Test Progress Dialog, click Run to launch the shortcut. The Test Result Dialog opens. 


E Test Result 


p Did "wsa" Work Properly? 


Comment; 


4. Following an attempt to launch the shortcut, the Test Result dialog appears. Click Yes or No depending 


on whether the shortcut launched correctly. You can also enter comments in the Comment field on this 
dialog. 


Checking Type Libraries 


lais 


To check type library functionality: 


1. With QualityMonitor launched and the application you are testing open, select Type Libraries from the 
View List. The Type Libraries View opens. 


+ PackageForTheWeb 4 - InstallShield QualityMonitor 
File Yiew Test Case Execute Tools Help 


EE- E 
PackageForTheweb 4 
=) Test Cycle Summary 

= Deployment Tests 
C off Class IDs Test Case Status 


U x) File Associations Choose a status For the entire test Total test items: 1 
C p] Prog IDs case 


vi BY Shortcuts Crane vV] Passed: 1 (100%) 
GA Type Librarie X] Failed: 0 (0%) 
© Lockdown and Runtime Te Gp 4 rv) 
G I| m ` ore 
8 User-Defined Tests ae D C Pending: 0 


| Type Libraries 
Type Libraries test case details 


Test Case Progress Comments 


C Failed 


Last Run At: 07-14-2003 02:41:48 PM 


Test Items 


View these test items: |74 Al = Run All | Reset Results | 
File Name 
Passed {032EA43F-4FA7-11D5-852B-0080D023820D} PFWServer 1.0 Type Library C:\Program Files\InstallShield\PackageForTheweb 


2. Right-click on the Test Item you want to run and select Run. You can also select multiple Test Items to 
run, or click Run All to run all available Test Items. 
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3. When testing is finished, results are recorded in the Test Case Progress area. 
When a Test Item is failed, you can view details about it, including the error message associated with it on the 


Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 
from the context menu. 


Checking ODBC Data Sources 


To check ODBC data sources: 


1. With QualityMonitor launched and the application you are testing open, select ODBC Data Sources 
from the View List. A list of data sources in that application appears in the lower portion of the ODBC 
Data Sources View. 


Microsoft Office XP Professional - InstallShield QualityMonitor 


File View Test Case Execute Tools 


CAIRNE E 


(A Microsoft Office XP Professional 


~"H@ ODBC Data Sources 


| Test Cycle Summary 
=] ib Deployment Tests 
ef Class IDs 
x] File Associations 
Help Files 
Ww Prog IDs 
E Shortcuts 
W Type Libraries 
p=] ODBC Data Sources 
© Lockdown and Runtime Tests 


ODBC Data Sources test case details 


Test Case Status 


Choose a status for the entire test 


case 
@ Pending 
C Passed 


© Failed 


Test Case Progress r Comments 


Total test items: 5 | 
0 (0%) 


0 (0%) 


V| Passed: 


X] Failed: 


Pending: 5 (100 


a User-Defined Tests 


Last Run At: 


Test Items 


View these test items: All hd | 


Pending Excel Files 
g MS Access Database 
visual FoxPro Database 


g Visual FoxPro Tables 
» ADACC Cila- 


Microsoft Excel Driver (*. xls) 
Microsoft Access Driver (*.mdb) 
Microsoft Visual FoxPro Driver 


Microsoft Visual FoxPro Driver 
Fb dD mem Pitre E AREY 


Run All | Run | Reset Results | 
EnEn e E V E | 


User 
User 
User 
User 


Only those data sources that belong to the current logged-in user are listed. 


2. Select the Test Item you want to run and click Run. You can also select multiple Test Items to run, or click 
Run All to run all available Test Items 
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For certain ODBC data sources, additional connection information is required for verification. When the tests 
are run in Full user interface mode, additional dialogs may be displayed during the test to take more input. 
However, when the tests are run in Silent user interface mode, these additional dialogs will not be displayed 
and results will be based on default information. 


3. When testing is finished, results are recorded in the Test Case Progress area. 


When a Test Item is failed, you can view details about it, including the error message associated with it on the 
Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 
from the context menu. 


Checking ODBC Drivers 


To check ODBC drivers: 


1. With QualityMonitor launched and the application you are testing open, select ODBC Drivers from the 
View List. A list of drivers in that application appears in the lower portion of the ODBC Drivers View. 


+ Crystal Reports - InstallShield QualityMonitor [C:\AdminStudio Shared\Crystal Reports.iqm] 
File View Test Case Execute Tools Help 
] 
[$a 
Crystal Reports BM ODBC Drivers 
=) Test Cycle Summary ODBC Drive 
= Deployment Tests 


Class IDs r Test Case Status pes Case Progress ———~~~~~~~~ ‘Comments 
a File Associations 


Choose a status for the entire test | Totaltest items: 7 
Help Files case | 


v] id IDs aes | V] Passed: 0 (0%) 
a ibe | BE Failed: 0 (0%) 
FS] ODBC Drivers| C Passed | Pending: (100%) 
# ODBC Data Sources C Failed | 

35 Lockdown and Runtime Tests 


ĝ User-Defined Tests 


Last Run At: 


Test Items 


View these test items: Z All z] Run All | Run | Reset Results | 


Sas Ie i e N 
en CR DB2 C:\WINDOWS\System32\Crdb214.dll 
CR Informix C:\WINDOWS\System32\Crinf14.dll 
9g CR Informix9 C\WINDOWS\System32\Crinf91 4. dll 
CR Oracle? C:\WINDOWS\System32\Cror7 14. dll 
CR Oracles v3.6 C:\WINDOWS\System32\CROR815,DLL 
CR Sybase System 10 C:\WINDOWS\System32\Crsyb14.dll 
a CR XML v3.6 C:\WINDOWS\System32\CRXML15.DLL 
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Only those drivers that belong to the current logged-in user are listed. 


2. Select the Test ltem you want to run and click Run. You can also select multiple Test Items to run, or click 
Run All to run all available Test Items. 


For certain ODBC drivers, additional connection information is required for verification. When the tests are 
run in Full user interface mode, additional dialogs may be displayed during the test to take more input. 
However, when the tests are run in Silent user interface mode, these additional dialogs will not be displayed 
and results will be based on default information. 


3. When testing is finished, results are recorded in the Test Case Progress area. 


When a Test Item is failed, you can view details about it, including the error message associated with it on the 
Test Item Information Dialog. To access this dialog, select the Test Item and then select Test Item Information 
from the context menu. 


Lockdown and Runtime Testing 


Lockdown and runtime tests are available through the Lockdown and Runtime Tests View. You are provided with a 
list of available shortcuts in the package and all of the executables in the package. You can then launch via the 
shortcut or executable, and exercise functionality in the application. When you close the application, information 
about the executable is listed under the Runtime Checks node. This information, grouped into Files, Registry Entries, 
and Folders views, allows you to see failures in the application execution. These are potential issues with the 
application, and may or may not have any affect on the overall package integrity. 


If you want to execute tests in the context of a different user (under a different user account), click Run As instead of 
Run to execute the test. You would then be prompted to enter a User Name and Password. For more information, 
see Performing Lockdown and Runtime Tests Under a Different User Account. 


Lockdown and runtime tests are only supported on Windows NT4, 2000, and XP. 
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Performing Lockdown and Runtime Tests 


To perform lockdown and runtime tests: 


1. From the View List, select Lockdown and Runtime Tests. The Lockdown and Runtime Tests View opens. 


+ Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Wicrosoft Office XP Professional.iqm] DER) 


Fie View TestCase Execute Tools Help 


IEAI EE E4 


] Dkerosott Office XP Professional =E Lockdown and Runtime Tests 
=| Test Cycle Summary . Perform runtime check lecting an executable or shortcut 
= Deployment Tests 


ogy Class IDs 
go 3 File Associations Select a shortcut or executable from the following list. The selected item will be launched and monitored during its 


execution. If there are any errors, they will be reported after the execution ends. 


Help Files 

m) w) Prog IDs 

C E Shortcuts 
CIM Type Libraries 


C Fl ODBC Data Sources Shortcut Name 

o Lockdown and Runtime Tests Microsoft Office Document Imaging C:\Program Files\Common Files\Microsoft Shared\MSPaper\MSPVIE— 
8 User-Defined Tests Microsoft Access C:\Program Files\Microsoft Office\Office10\MSACCESS.EXE 
Microsoft Outlook C:\Program Files\Microsoft Office\Office 1 0\OUTLOOK.EXE 

Save My Settings Wizard C:\Program Files\Microsoft Office\Office 10\PROFLWIZ.EXE 


BAL meee mm Ch Pines Naimb OMen munes Mile UA ene me EE AEC LAEE n Catrina cor 


© Select an Executable 


Executable Name 

c:\program files\microsoft office\office10\msqry32.exe 

c:\program files\common Files\system\mapi\1033\ml3xec16,.exe 
c:\program files\microsoft office\office10\1033\schdpl32.exe 
c:\program files\microsoft office\office10\nsrex.exe 

c:\program files\common files\microsoft shared\msinfo\offprv10.exe 
cnranram Filectcammmoan FilecimicrncoFt charedimenanerimenviem eve 


Run As... 


2. Select either the Select a Shortcut or Select an Executable option. 

3. Select the shortcut or executable to run. 

4. Click Run. 

5. When the application launches, use the application in a normal way, performing various operations. 


6. Exit the application. 


QualityMonitor reports the application name and any access failures for files, folders, or registry entries in nodes 
below Lockdown and Runtime Tests in the View List. 


HE Lockdown and Runtime Tests 
=) By Microsoft Access 

x |) Files 

X| Registry Entries 
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When you select a node, the right side of the Lockdown and Runtime Tests View displays the view for that selected 
node, allowing you to view the error message for each Test Item on the Test Item Information Dialog. 


Microsoft Office XP Professional - InstallShield QualityMonitor DER 
Fie View TestCase Execute Tools Help 


|S h|! 8 9 
(=) 4&4 Microsoft Office XP Professional 


=) Test Cycle Summary 
=| Deployment Tests 


Registry Entries 
ist of registry entries which could not be ac 


sed during application execution 


sa Class IDs Test Case Status Test Case Progress Comments 
X] File Associations Choose a status for the entire test Total test items: 130 

Help Files case 

Prog IDs C pend W| Passed: 0 (0%) 

ending a 

EM Shortcuts — X] Failed: 130 (100%) 
W. Type Libraries C Passed Xx] 
Fi ODBC Data Sources asa l Pending: 0 (0%) 


=) Lockdown and Runtime Tests 
H-E Microsoft Access 


C Fate Ss 


[X] |_] Files 
EIE: AR 
a User-Defined Tests 
Test Items 
View these test items: [ual >| Reset Results 

| Status | Registry Location N 
Failed HKEY_CLASSES_ROOT\AppID\MSACCESS.EXE =z 
Failed = HKE¥_CLASSES_ROOT\CLSID\{019F7 150-E6DB-11D0-83C3-00C04FDDB82E} = 
Failed HKEY_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEB81267B80}\InprocHandler32 
Failed  HKE¥_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEB8 1267680} \InprocHandlerx86 
Failed = HKEY¥_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEB81267B80}\InprocServerx86 
Failed = HKEY_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEB81267B80}\LocalServer 
Failed = HKE¥_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEB81267B80}\LocalServer32 
Failed HKEY_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFED}\InprocHandler32 
Failed = HKEY_CLASSES_ROOT\CLSID\{33C53450-F456-4884-B049-85FD643ECFED}\InprocHandlerx86 
Failed HKEY_CLASSES_ROOT\CLSID\{33C53450-F456-4884-B049-85FD643ECFED}\InprocServerxa6 
Failed = HKEY_CLASSES_ROOT\CLSID\{33C53450-F456-4884-B049-85FD643ECFED}\LocalServer 
Failed = HKEY_CLASSES_ROOT\CLSID\{33C53450-F456-4884-B049-85FD643ECFED}\LocalServer32 
Failed = HKE¥_CLASSES_ROOT\CLSID\{3CE74DE4-53D3-4D74-8B83-431B3828B453}\InprocHandler32 
Failed  HKEY_CLASSES_ROOT\CLSID\{3CE74DE4-53D3-4D74-8883-431B3828B453}\InprocHandlerx86 w 
< i E 

Ready NUM A 
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Performing Lockdown and Runtime Tests Under a 
Different User Account 


You can use the Run As feature to execute Lockdown and Runtime tests in the context of a different user. This allows 
you to validate an application in a locked-down environment without actually requiring a user to log-in with a 
different set of credentials. This will reduce the test cycle effort significantly. 


fam 


8, 
To perform tests under a different user account: 


1. From the View List, select Lockdown and Runtime Tests. The Lockdown and Runtime Tests View opens. 


+ Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Wicrosoft Office XP Professional.iqm] DER) 


Fie Yiew TestCase Execute Tools Help 


Sh a|: 8 9 
(F Microsoft Office XP Professional zm? Lockdown and Runtime Tests 
| Test Cycle Summary s Perform runtime checks by selecting an executable or shortcut 
= Deployment Tests 
O og Class IDs 
_] X] File Associations 
E Help Files 


Select a shortcut or executable from the following list. The selected item will be launched and monitored during its 
execution, If there are any errors, they will be reported after the execution ends. 


—] y) Prog IDs 

_] EY Shortcuts 

E Type Libraries 

#1 ODBC Data Sources Shortcut Name Target File x 
E Lockdown and Runtime Tests Microsoft Office Document Imaging C:\Program Files\Common Files\Microsoft Shared\MSPaper\MSPVIE — 
a User-Defined Tests Microsoft Access C:\Program Files\Microsoft Office\Office10\MSACCESS.EXE 


Microsoft Outlook C:\Program Files\Microsoft Office\Office10\OUTLOOK.EXE 
Save My Settings Wizard C:\Program Files\Microsoft Office\Office 10\PROFLWIZ.EXE 


PPPE i r E ANM n muneme Mile UNM ene me Ck ACE LAEE n Catena cur 


< Lill 


© Select an Executable 


Executable Name 

c:\program files\microsoft office\office10\msqry32.exe 
c:\program files\common Files\system\mapi\1033\ml3xec16,.exe 
c:\program files\microsoft office\office101033\schdpl32.exe 
c:\program Files\microsoft office\office10\nsrex.exe 


c:\program files\common files\microsoft shared\msinfo\offprv10.exe 
cinrnaram Filecicammoan Filecimicrnenft charedimenanerimenviem eve 


2. Select either the Select a Shortcut or Select an Executable option. 


3. Select the shortcut or executable to run. 


4. Click Run As. 


You are then prompted to enter a User Name and Password. Enter the User Name in the format of: 
DOMAINNAME \UserName. The default value is the current User Name. 


Run As can also be selected using the Shift+F5 shortcut, or by selecting Run As from the Execute menu. 
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5. When the application launches, use the application in a normal way, performing various operations. 


6. Exit the application. 


QualityMonitor reports the application name and any access failures for files, folders, or registry entries in nodes 
below the Lockdown and Runtime Tests view. 


=) Lockdown and Runtime Tests 
E Microsoft Access 
X] |) Files 


X| a Registry Entries 


When you select a node, the right side of the Lockdown and Runtime Tests View displays the view for that selected 
node, allowing you to view the error message for each Test Item on the Test Item Information Dialog. 


Microsoft Office XP Professional - InstallShield QualityMonitor DE xX 
Fie View TestCase Execute Tools Help 


|© kh A|! ae 
f=] Microsoft Office XP Professional 


=) Test Cycle Summary 
Deployment Tests 


a $# Registry Entries 
€ Displays a list of regis 


y entries which could not be a during application execution 


sa Class IDs Test Case Status Test Case Progress Comments 
X] File Associations Choose a status for the entire test Total test items: 130 
J Help Files case 
a Prog IDs Pied V| Passed: 0 (0%) 
ending 
J By Shortcuts Z] Failed: 130 (100%) 
WA Type Libraries Ce d x! 
Fi ODBC Data Sources asa | Pending: 0 (0%) 


=) Lockdown and Runtime Tests 
H-H Microsoft Access 

X] |_] Files 

(x! y Entries 

a User-Defined Tests 


@ Fate EE 


Test Items 


View these test items: Fà All X | 


Reset Results 


ls 


HKE'Y_CLASSES_ROOT\AppID\MSACCESS.EXE 
HKEY_CLASSES_ROOT\CLSID\{019F7150-E6DB-1 1D0-83C3-00CO4FDDB82E} 
HKEY_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEBS1267B80}\InprocHandler32 
HKE'Y_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEBS1267B80}\InprocHandlerx86 
HKEY_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEBS1267B80}\InprocServerx86 
HKE'Y_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEBS1267B80}\LocalServer 
HKEY_CLASSES_ROOT\CLSID\{1443904B-34E4-40F6-B30F-6BEBS1267B80}\LocalServer32 
HKEY_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFED}\InprocHandler32 
HKE'Y_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFED}InprocHandlerx86 
HKEY_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFED}InprocServerx86 
HKEY_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFED}\LocalServer 
HKEY_CLASSES_ROOT\CLSID\{33C53A50-F456-4884-B049-85FD643ECFEDHLocalServer32 
HKEY_CLASSES_ROOT\CLSID\{3CE74DE4-53D3-4D74-8B83-431B3828BA53}\InprocHandler32 
Failed  HKEY_CLASSES_ROOT\CLSID\{3CE74DE4-53D3-4D74-8B83-431B3828BA53}\InprocHandlerx86 


< M 


| 
Boot C nn, 
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Running Lockdown and Runtime Tests in Restricted 
Environments 


When executing runtime tests in a locked-down environment, you may encounter an error "Unable to monitor the 
application execution." This can happen if QualityMonitor is unable to set up the environment to launch the 
monitoring process. 


To avoid this problem, install a standalone version of InstallShield Repackager on a clean Windows NT4 system. This 
Repackager installation setup can be downloaded at the following URL: 


http://support. installshield. com/kb/fi1les/Q108601/setup.exe 


This setup will correctly configure the monitoring environment. After installing the setup, start the monitoring 
process. 


W A) 
This independent setup.exe requires Admin privileges to install. To install this setup, log in as an administrator, run the 
setup, and then log back in as a normal user to run the tests in the locked-down environment. 


Performing Isolation Tests 


You can run Isolation Tests to display the location of all PE files (dll/ocx/exe/tlb/olb) that are launched from a 
process while performing a Lockdown and Runtime test. Viewing a listing of these PE names and paths makes it 
easier for you to ensure that the application is fully isolated. 


The Isolation Tests node will be added to the Lockdown and Runtime Tests tree only if the selected executable launches 
at least one PE file. 


You can specify when you would like the Isolation Tests node to be added by going to QualityMonitor's Main Menu 
and selecting Options from the Tools menu, and then selecting an option from the Show Isolation Tests list. 


f \ 
\ j 
g j 


QualityMonitor does not support isolation testing under Windows 2000. 
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a 
To perform isolation tests: 


1. From the View List, select Lockdown and Runtime Tests. The Lockdown and Runtime Tests View opens. 


+- Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Wicrosoft Office XP Professional.iqm] DER) 


Fie View TestCase Execute Tools Help 


EAEE E- 
Microsoft Office XP Professional m Lockdown and Runtime Tests 
| Test Cycle Summary | Perform runtime checks by selecting an executable or shortcut 
= Deployment Tests 


2f4y Class IDs 
J 3 File Associations Select a shortcut or executable from the following list. The selected item will be launched and monitored during its 


execution. If there are any errors, they will be reported after the execution ends. 


Help Files 

LJ wv) Prog IDs 

C E Shortcuts 

E Type Libraries 

COȘA ODBC Data Sources 

‘© Lockdown and Runtime Tests Microsoft Office Document Imaging 

& User-Defined Tests Microsoft Access C:\Program Files\Microsoft Office\Office10\MSACCESS,EXE 
Microsoft Outlook C:\Program Files\Microsoft Office\Office 10\OUTLOOK,.EXE 
Save My Settings Wizard C:\Program Files\Microsoft Office\Office10\PROFLWIZ.EXE 


coe meres Mile AURA ane eof AEC LACE. AAT cur 


RA ae walk eee Maink rin. 


$i Lilt 


© Select an Executable 


Executable Name 

c:\program files\microsoft office\office10\msqry32.exe 
c:\program files\common Files\system\mapi\1033\ml3xec16,.exe 
c:\program files\microsoft office\office101033\schdpl32.exe 
c:\program Files\microsoft office\office10\nsrex.exe 


c:\program files\common files\microsoft shared\msinfo\offprv10.exe 
cinrnnram Filectcammoan Filecimicrnenft charedimenanerimenviem eve 


2. Select either the Select a Shortcut or Select an Executable option. 
3. Select the shortcut or executable to run. 


4. Click Run. 


After a Lockdown/Runtime test is performed for an executable (.EXE) or a shortcut, an additional node 
called Isolation Tests is added to the tree under the executable or shortcut node. 


H-4 Lockdown and Runtime Tests 
(=) BY Microsoft Access 


x Registry Entries 
| Isolation Tests 
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5. Select the Isolation Tests node. The filenames of the PE files and their paths is displayed in the list 
control of the view. By default, the status of all of the items in this test case is Pending. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Professional.iqm] [£ |(C)|[| 
File Yiew TestCase Execute Tools Help 


\Gu|/ a): a 


fi i i Isolation Tests 
=) Test Cycle Summary verify Application’s Isolation 


Deployment Tests 
a Class IDs Test Case Status 1 Test Case Progress f Comments 
X) File Associations Choose a status for the entire test Total test items: 33 
Help Files case 
\v) Prog IDs inns V| Passed: 0 (0%) 
* Pending z 

a Shortcuts Í X] Failed: 0 (0%) 

W Type Libraries 

Fi ODBC Data Sources 


=) Lockdown and Runtime Tests C Failed ee eee 
E-E Microsoft Access 

x Registry Entries a g 
S| Isolation Tests 

=| 8 User-Defined Tests 


[2] Test Case Test Items 
| eB Deployment Status 


H-E ProductFiles View these test items: | F all x] _Reset Results Results 
H-E OfficeUserData 


mcd atus | ena etn a e aM 
ae HiddenFeatures SKCHUI,.DLL C:\Program Files\Common Files\Microsoft Shared\Ink\ 
E WebPublFiles g mso.dll C:\Program Files\Common Files\Microsoft Shared\office 10}, 
riched20.dll C:\Program Files\Common Files\Microsoft Shared\office 10}, 
g msain.dll C:\Program Files\Microsoft Office\ Office 1041033), 
srintl. dll C:\Program Files\Microsoft Office\Office 1041033), 
g MSACCESS.EXE C:\Program Files\Microsoft Office\Office10\, 
J3 msostyle.dll C:\Program Files\Microsoft Office\Office10\ 
J SPGRMR,DLL C:\WINDOWS\IME\, 
9 CLBCATQ.DLL — C:\WINDOWS|\System32\, 
J COMRes.dll C:\WINDOWS|System32) 
g MSCTF.dll C:\WINDOWS|System32) 


© Passed 


Pending: 33 (100 


6. To ensure that all of the executables or shortcuts in this test case are isolated, go to the Test Case Status 
area of the view, and set the status of the entire test case to either Pending, Passed, or Failed. 


Using MSI Doctor to Verify Package 
Deployment Status 


You can use QualityMonitor's MSI Doctor to verify if an MSI package is installed properly. This helps prevent users 
from seeing an auto-repait dialog when they run the application. Auto repair messages are displayed by applications to 
attempt to reinstall missing/corrupted components. By examining an application using QualityMonitor MSI Doctor, 
you can quickly identify any problems by checking the status of all products and features. Using MSI Doctor, you can: 


See the status of all components 

Verify if any files are missing or if any files do not match the version or size specified in the MSI file 
See the components status segregated by features 

Configure or reinstall features 

Reinstall components 


To use MSI Doctor, select the Deployment Status W node from the QualityMonitor View List to access the 
Deployment Status View. 


InstallShield Software Corporation © 2004 610 


AdminStudio 5.5 User Guide 11 Ensuring Package Quality 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Professio... [E \(C|(K] 


File View Test Case Execute Tools Help 
|© kh g|: ae 
E- Microsoft Office XP Professional E] Deployment Status 
a Test Cycle Summary DEF List of all the components in the MSI package 
Deployment Tests 
H- Lockdown and Runtime Tests 
| By Microsoft Access 
User-Defined Tests 
Deployment Status 
| 9 ProductFiles 
=|) 9 OfficeUserData 
& AccessUserData 
& ExcelUserData 
9 OutlookUserData 
E PowerPointUserData 
E WebDriveUserData 
E WordUserData 
=| € AlwaysInstalled 
E opcRemovePreviousMax 
3 oPpcRemovePreviousMin 
9 AlwaysHelper 
© Officalinternal 
9 ShortcutSupport 
) 9 HiddenFeatures 
© SpeechHidden 
9 TranslationHidden 
9 HandWritingHidden 
9 WebPublFiles 


ES Component Name Component Status _ ^ 
Global_Jet_Replication Installed on local Dri 
Global_PowerPoint_PowerCastNetShowS¥R Installed on local Dri — 
Global_MediaStore_Core Installed on local Dri 
skchui.dll.9846701C_B1E3_426B_BC32_9692446A5947 Installed on local Dri 
Global_Access_SnapshotSys Installed on local Dri 
msb1xtor.dll.B0462459_943D_460D_BFD4_D367D28FAEED Installed on local Dri 
Global_Access_SnapshotCore Installed on local Dri 
AllOtherFiles. AF¢044F8_9187_4E0C_A423E_344075B53E7C Installed on local Dri 
AllotherFiles.B06CD494_77FD_4E8C_4601_0752547F758E Installed on local Dri 
AutoCorrectLists. DODF3458_4845_11D3_8D04_0050046416B9 Installed on local Dri 
AutoCorrectLists_1036.DO0DF3458_4845_11D3_8Db04_0050046416B9 Installed on local Dri 
AutoCorrectLists_3082.D0DF3458_4845_11D3_8Db04_0050046416B9 Installed on local Dri 
CS5SPkg_Reg._MSE.3643236F_FC70_11D3_4536_009027841BB8 Installed on local Dri 
C55_Package_ENU_X86,3643236F_FC70_11D3_4536_009027841BB8 Installed on local Dri 
CS55_Package %86.3643236F_FC70_11D3_4536_009027841BB3 Installed on local Dri 
C_TermServerRegistry. A373E4B3_7487_11D3_B1C1_00C04F68155C Not installed 
C_athprxy_dll.4373E4B3_7487_11D3_B1C1_00C04F68155C Not installed 
C_dsscntrs_h.4373E4B3_7487_11D3_B1C1_00C04F68155C Not installed 
C_dsscntrs_ini.4373E4B3_7487_11D3_B1C1_00C04F68155C Not installed 
C_ftsqlpar_dll,A373E4B3_7487_11D3_B1C1_O0CO4F68155C Not installed 


C nathrnrm tyt.Aa7aF4R3 FAR? 11DR RIC1 NNCN4FARISSC Not installed ~i 
Í | > 


"hal 7 


i=} 
i=) 
i=] 
i=] 
i=] 
i=] 
i=] 
i=) 
i=] 
i=] 
i=] 
i=) 
i=) 
i=) 
i=] 
x 
x 
x 
x 
x 
x 
$ 


On the Deployment Status View, the following icons are displayed in the tree view and in the component list: 


Icon Name Description 

= installed Feature or Component is installed on the local machine. 

x Uninstalled Feature or Component is not installed on the local machine. 

@ Broken Component is broken (a key file in the Component is missing) or Feature contains a broken 

Component. 

&@ Run From Feature or Component is configured to run from a source location (rather than being 
Source installed on the local machine). 

f OnDemand Feature is configured to be installed when needed. Not applicable to Components. 
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Context Menu Functionality 


The following table lists the functions available on the context menus for the Deployment Status icon, Features, and 
Components, and the dialogs that appear when those functions are selected: 


Function Deployment Status Feature Component 
Configure Install or Configure Install or Configure N/A 
Product Feature 
Re-install  Re-install Re-install Installation program is launched. (This option is only 
Product/Feature Product/Feature enabled if the selected Component is broken.) 
Properties Product Properties Feature Properties Component Properties 


Using MSI Doctor, you can perform the following tasks: 


View Product and Feature Deployment Status Properties 
Verify Product or Feature Files 

Install or Configure Products or Features 

Reinstall Features 


View Product or Feature Deployment Status 
Properties 


ge \ 


Bi 


To view product or feature deployment status properties: 


1. Launch QualityMonitor and open the package that you want to view the deployment status 
properties of. 


2. Select one of the following: 


m To view Product properties, select Deployment Status from the View List. 


m To view Feature properties, select a Feature icon under Deployment Status on the View List. 


3. Select Properties from the context menu. The Product Properties or Feature Properties Dialog appears, 
displaying property information for the Product or the selected Feature. 
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Feature Properties Product Properties 


General General 


Name: ProductFiles Version: 10.0.4330.0 

Title: Microsoft Office Publisher: Microsoft Corporation 

Parent: Product Code: {90110409-6000-11D3-8CFE -0050048383C9} 

Description: Office programs, plus additional content and tools. Local CAWINDOWS\Installer\] a4ed4. msi 

Last Used: Wednesday, January 07, 2004 Registered To: InstallShield Software Corporation 

Status: Installed on local Drive Product ID 54186-640-1985775-1 7073 

Usage Count: 4968 Status: The product is installed for the current user 
Help Link: http://www. microsoft. com/support 
Installed on: 02-28-2003 


Installed from: DA 


4. Click OK to exit the Properties dialog. 


Verify Product or Feature Files 


To verify product or feature files: 
1. Launch QualityMonitor and open the package that you want to verify the files of. 
2. Select one of the following: 


To verify all of the files in all of the Features in the Product, select Deployment Status from the View 
List. 


To verify only the files in the selected Feature, select a Feature icon under Deployment Status on the 
View List. 


3. Select Properties from the context menu. The Product Properties or Feature Properties Dialog appears, 
displaying property information for the Product or the selected Feature. 
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Product Properties (X Feature Properties 


General General 


Version: 10.0.4330.0 Name: ProductFiles 

Publisher: Microsoft Corporation Title: Microsoft Office 

Product Code: {90110409-6000-11D3-8CFE -0050048383C9} Parent: 

Local C:\WINDOW'S \Installer\1 a4ed4. msi Description: Office programs, plus additional content and tools. 
Registered To: InstallShield Software Corporation Last Used: Wednesday, January 07, 2004 

Product ID 54186-640-1985775-1 7073 Status: Installed on local Drive 

Status: The product is installed for the current user Usage Count: 4968 

Help Link: http://www. microsoft.com/support 

Installed on: 02-28-2003 

Installed from: D; 


OK | Cancel | Help | 


4 


OK | Cancel | Help | 


4 


4. Click Verify Files. When you click Verify Files, QualityMonitor checks all of the files included in the 
Product or selected Feature and then displays them on the Files Dialog. Files that are either missing or 
have a different version or size than that specified in the MSI package are identified by the following 


icon: a. 


|__| kocation le Key | Component | Install Size ^ 
P C:\Program Files\Microsoft Office\Office10\Borders\MSART1,.BDR MSART1.BDR  Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART10.BDR MSART10.BDR Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART11.BDR MSART11.BDR Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART12.BDR MSART12.BDR Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART13.BDR MSART13.BDR Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART14.BDR MSART14.BDR Global_Word_WordBorders 


C:\Program Files\Microsoft Office\Office10\Borders\MSART15.BDR MSART1S.BDR Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART2.BDR MSART2.BDR  Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART3.BDR MSART3.BDR  Global_Word_WordBorders 
C:\Program Files\Microsoft Office\Office10\Borders\MSART4.BDR MSART4.BDR  Global_Word_WordBorders 


C:\Program Files\Microsoft Office\Office10\Borders\MSARTS.BDR MSARTS.BDR  Global_Word_WordBorders v 
i | > 


15 File(s) Help | 


5. Click Close to exit the Files dialog, and click OK to exit the Properties dialog. 


COCCLCCCOCCOCOCo 
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Install or Configure Products or Features 


You can use Configure to install a product or feature that is not currently installed. 


gi* 


Bi 


To install or configure products or features: 


1. Launch QualityMonitor and open the package that you want to install or configure. 


2. Select one of the following: 


m To install or configure the entire Product, select Deployment Status from the View List. 


m To install or configure only the selected Feature, select a Feature icon under Deployment Status on the 


View List. 


3. Select Configure from the context menu. The Install or Configure Product or Install or Configure Feature 
Dialog appears, prompting you to select the installation location and the installation type (on the Install 


or Configure Product Dialog only). 


Install or Configure Product 


This will attempt to install or configure the selected product to the 
settings you specify. To complete this operation, you may need the 
source From which the selected product was installed. 


Product Settings 


Please select the new installation 


C Local (Files will be installed on the local machine) 
© Source (Files will be run From the installation source) 
© OnDemand (Files will be installed when needed) 


Please select the new installation 


Minimum (only the essential Features will be installed) 


(© Typical (Most commonly used features will be installed) 
© Complete (All of the program's features will be installed) 


Install or Configure Feature 


This will attempt to install or configure the selected feature to the 
settings you specify. To complete this operation, you may need the 
source From which the selected feature was installed, 


Feature Settings 


C Local (Files will be installed on the local machine) 
© Source (Files will be run from the installation source) 
© On Demand (Files will be installed when needed) 


cot |__| 


4. Select one of the following options to specify installation location: 


= Default—Files will be installed to their default location. 


= Local—Files will be installed on the local machine. 


= Source—Files will be run from the installation source. 


= On Demand -—Files will be installed when needed. 
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5. (Product only) Select one of the following options to specify installation type: 


m Minimum-— Only the essential features will be installed. 
m Typical—Most commonly used features will be installed. 


= Complete—All of the program's features will be installed. 


6. Click OK. The Product or Feature is installed, per the options you specified. 


When a Feature is broken (identified by the Œ} icon, you can fix it by re-installing the entire Product or just re- 
installing the broken Feature. 


AAN 


| -— 
ay 


To reinstall features: 

1. Launch QualityMonitor and open the package that you want to reinstall. 

2. Select one of the following: 

3. To reinstall the entire Product, select Deployment Status from the View List. 

4. To reinstall only the selected Feature, select a Feature icon under Deployment Status on the View List. 


5. Select Re-install from the context menu. The Re-install Product/Feature Dialog appears, prompting you to 
select a reinstall mode. 


Re-install Feature 


Select Reinstall Mode: 


© Reinstall only if file is missing 


© Force all files to be reinstalled 
Additional Reinstall Modes: 
© Reinstall if file is missing, or an older version exists 
© Reinstall if file is missing, or an older or equal version exists 
© Reinstall if existing file has different version 
© Yerify that required user registry entries are present 
C verify that required local machine registry entries are present 
© Recreate all shortcuts 


cot |__| 


6. Select one of the following reinstall modes: 


Repair all detected reinstall problems 


Reinstall only if file is missing 


Force all files to be reinstalled 


Reinstall if file is missing, or an older version exists 


InstallShield Software Corporation © 2004 616 


AdminStudio 5.5 User Guide 11 Ensuring Package Quality 


m Reinstall if file is missing, or an older or equal version exists 
m Reinstall if existing file has different version 

m Verify that required user registry entries are present 

m Verify that required local machine registry entries are present 


m Recreate all shortcuts 


7. Click OK. The Product or Feature is re-installed, per the option you specified. 


InstallShield Software Corporation © 2004 617 


AdminStudio 5.5 User Guide 11 Ensuring Package Quality 


Creating Custom Test Cases 


QualityMonitor supports adding additional, custom Test Cases to projects—based on your business needs. 


Adding User-Defined Test Cases 


US 


To add a user-defined case: 


1. Right-click on the User-Defined Tests view and select Add Test Case. 


File view TestCase Execute Tools Help 


a i se 
AIEE T 
Microsoft Office XP Professional User-Defined Tests 
=| Test Cycle Summary Summary for user-defined test cases 
Deployment Tests 


Tağ Class IDs 
E File Associations User-Defined Tests Summary 


Help Files 


CI y) Prog IDs 
|_| EA) Shortcuts 
Es Type Libraries 


ŞT ODBC Data Sources V) Passed 0 (0%) 


r User-Defined Tests Progress 


Total test cases: 0 


H- Lockdown and Runtime Tests 


8 User-Defined Tesh el eE>iled 0 (0%) 
Add Test Case... 


nding 0 (0% 


User-Defined Tests Tasks 


E] Add a user-defined test case 


A new Test Case appears below the User Defined Tests node, and you are prompted to enter a name. 


| 8 User-Defined Tests 
(9) Test Caset 


Eest casei 


2. Name the Test Case appropriately. 
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3. Select the new Test Case to open the Test Case View. 


+ Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Profe... DAR) 
File Yiew Test Case Execute Tools Help 


|e hA: AS 
Microsoft Office XP Professional 
2 Test Cycle Summary 
Deployment Tests 
of4y Class IDs Test Case Status 


X] File Associations Choose a status for the entire test 
Help Files case 


WW] Prog IDs 
E Shortcuts @ Pending 
W Type Libraries 

i ODBC Data Sources © Passed 
=) Lockdown and Runtime Tests C Failed 

=| BJ Microsoft Access 

[X] |_] Files 

Xa Registry Entries Fan, 
=] a User-Defined Tests eerie 
5] Test Casel 


Test Case2 
Details for this user-defined test case 


= ey Deployment Status 
+- ProductFiles 

+- OfficeUserData 

+) & AlwaysInstalled 

+- HiddenFeatures 
E WebPublFiles 


4. Under Test Case Status, specify the status for this Test Case: Pending, Passed, or Failed. 


5. In the Instructions text box, enter any necessary comments. 


For example, you may want to create a custom Test Case to ensure that a specific database is updated properly after 
running an application. 


Renaming User-Defined Test Cases 


To rename a user-defined Test Case: 


1. Right-click on the Test Case in the View List and select Rename. 


2. Provide a new name for the Test Case. 
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Test Reports 


QualityMonitor allows you to create an HTML test report for the current project. This can be done by selecting 
Generate Report from the File menu and providing the name and location for the report. The report will then 
automatically open in your default browser. 


a Report - Microsoft Internet Explorer 
File Edit View Favorites Tools Help 


InstallShield QualityMonitor's Report for 
Symantec AntiVirus Client 


Author : Symantec Corporation 
ProductCode: {OEFC6259-34D8-4CD2-BC57-D49374FSCCOE} 
Version: 8.0.0,374 


Class IDs Test Case 


Total: 5 Passed: 0 
Pending: 5 Failed: 0 


{0002E005-0000-0000-c000-000000000046} Pending 
{7EBDAASEO-8120-11CF-899F-004400688B 10} Pending 
{7EBDASE1-8120-11CF-899F-004400688B10} | Pending 
{7EBDAAE2-8120-11CF-899F-004400688B10} Pending 
{E381F1C0-910E-11D1-4B1E-O040C90FS8F6F} | Pending 


Help Files Test Case 


Total: 10 Passed: 0 
Pending: 10 Failed: 0 


Help File 


c:\program files\symantec_client_security\symantec 


antivirus\enucore.hip Pending 


c:\program files\symantec_client_security\symantec Pending & 


If an error message occurs when generating the report, it may be because msxml4.dll or isqm.xlst is not in the same 
directory as the QualityMonitor executable (isqm.exe). These files must be present to create the report. 
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Running QualityMonitor from the 
Command Line 


QualityMonitor can be run from the command line by using isqm.exe. It can accept the following parameters: 


Syntax Options Description 


-c <MSI Product Code> Launch QualityMonitor by opening the MSI product specified by 
the product code. For example: 


isqm.exe -c {BDC62375-07B4-ACBD-999 1-4C25C24F307 1} 
isqm.exe -c {BDC62375-07B4-4CBD-999 1-4C25C24F307 1} -sb -f 
<c:\projecttfile.iqm> 


-sn Run QualityMonitor silently without any user interaction and no 
progress display. 


-sb Run QualityMonitor silently with a progress display. QualityMonitor 
displays the test names as they are executed and provides an 
option for the user to cancel. 


-r <Report File> Generates a report file <c:\report.htm> with the test results. Works 
only when using either -sn or -sb. 


-f <Project File> Save test results in this file. This is necessary when using either -sn 
or -sb. If this file does not exist, it will be created and then results 
will be saved. 


-f <Project File> Launch QualityMonitor with this Project File. For example: 


isqm.exe -f c:\mydocuments\mytesting \tesresults.iqm 
isqm.exe -f c:\mydocuments\mytesting \tesresults.iqm -sn 


-sn Run QualityMonitor silently without any user interaction and no 
progress display. 


-sb Run QualityMonitor silently with a progress display. QualityMonitor 
displays the test names as they are executed and provides an 
option for the user to cancel. 


-r <Report File> Generates a report file <c:\report.htm> with the test results. Works 
only when using either -sn or -sb. 


-h or -? Help 
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When using any -sn or -sb command line options, you can specify the target product using the existing options /c or /f. 


= If you use the /f option to specify the product, the input file will be modified with the test results. 


= If you use /c to specify the target product, /f options must be used to specify the project file path which will have 
the test results. 


= If both /c and /f parameters are specified, then QualityMonitor gives preference to /c and operates with the 
product code specified by /c. 


QualityMonitor Reference 


Topics contained in this section provide detailed reference on each user interface element, dialog box, or view in 
QualityMonitor. This is the same documentation displayed when you click F1 from the QualityMonitor interface. 


Menus and Toolbar 


The following table provides a description of each of QualityMonitor's menu commands and toolbar buttons: 


Menu Command Toolbar Keyboard Description 
Button Shortcut 
File Open ie Ctrl+O Allows you fo open an existing QualityMonitor project 
l file (.iqm) or create a new one based on an installed 
MSl-based application. 
File Close Closes the current project. 
File Save | ed Ctrl+S Saves the current project. 
| 
File Save As Saves the current project using the name and location 
you specify. 
File Generate Creates an HTML test report for the current project. 
Report The report will automatically open in your default 
browser. 
File 1,2,3,4 Allows you to open the four most recently accessed 
QualityMonitor projects. 
File Exit Exits QualityMonitor. 
View Toolbar Toggles display of the toolbar. 
View Status Bar Toggles display of the status bar. 
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Menu Command Toolbar Keyboard Description 
Button Shortcut 
Test Case Add Test 3 Adds a custom Test Case beneath the Additional Tests 
Case — view in the View List. 
Execute All 15) Ctrl+F5 or Runs all the deployment tests in the current project. 
Deployment = Alt+E+D 
Tests 
Execute Run i F5 or Alt+E+R Runs the selected deployment, lockdown and runtime, 
or user defined test. 
Execute Run As a Shift+F5 Runs the selected lockdown and runtime test in the 
— context of a different user. You are then prompted to 
enter a User Name and Password. 
Tools Options Displays the Options dialog. 
Help Contents Launches the Help Library, displaying the Contents 
tab. 
Help Index Launches the Help Library, displaying the Index tab. 
Help Search Launches the Help Library, displaying the Search tab. 
Help Support Accesses AdminStudio Support Central on the Web. 
Central 
Help InstallShield Accesses the AdminStudio Community on the 
Community InstallShield Web site. 
Help ReadMe Displays the AdminStudio ReadMe file. 
Help Feedback Accesses the AdminStudio feedback form on the 
InstallShield Web site. 
Help InstallShield Accesses the InstallShield Web site. 
on the Web 
Help About Displays the About dialog. 
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QualityMonitor Interface 


The QualityMonitor interface is divided into two main areas. The View List, which appears at the left side of the 
screen, provides a visual representation of the QualityMonitor project file. It provides easy access to individual views 
and Test Cases. The right side of the interface changes depending on the view or Test Case selected. 


Symantec AntiVirus Client - InstallShield QualityMonitor 


File View Test Case Execute Tools Help 
[eh wg 
Symantec Antivirus Client = Lockdown and Runtime Tests 
=| Test Cycle Summary m Perform runtime checks by selecting an executable or shortcut 
E Deployment Tests 
C af Class IDs 


EJ Help Files Select a shortcut or executable from the following list. The selected item will be launched and monitored 
g Prog IDs during its execution. If there are any errors, they will be reported after the execution ends. 


Services 


C] E Shortcuts © Select a Shortcut 
Ws Type Libraries 


fy ALockdown and Runtime Tests Shortcut Name 


@ User-Defined Tests Symantec Antivirus Client C:\Program Files\Symantec_Client_Security\Symantec Antivirust\vpc 


@ Select an Executable 


Executable Name 

c:\program files\symantec_client_security\symantec antivirus\yvpc32.exe 
c:\program Files\symantec_client_security\symantec antivirus|rtvscan.exe 
c:\program files\symantec_client_security\symantec antivirus\Idypreg.exe 
c:\program files\symantec_client_security\symantec antivirus\savroam.exe 
c:\program files\symantec_client_security\symantec antivirus\nayustub,exe 
cinranram Filectevmanter client sectritwievmanter antiviriiclevmrcinin eve 


Run As... | 


In this example, Lockdown and Runtime Tests is selected, and on the right side of the interface you are prompted to 
select a shortcut or executable to test. 


e 
Dialogs 
The following dialogs are accessible from within QualityMonitor: 


About InstallShield QualityMonitor Dialog 


The About InstallShield QualityMonitor dialog, available by selecting About from the Help menu, displays 
information about QualityMonitor and AdminStudio, including version and serial number information. 


Component Properties Dialog 


The Component Properties dialog is displayed when you select a Component in the Component list on the right side 
of the Deployment Status View and select Properties from the context menu. 
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Component Properties 


General 


Name: Global_Outlook_Recall 

GUID: {E91 3BCD8-9560-11D1-8701-004400471E2D} 
Status: Installed on local Drive 

Location: C:\Program Files\Microsoft Office\Officel RECA 


OK Cancel Help 
oT ey ee 


Property Description 

Name Name of the selected Component. 

GUID Number which uniquely identifies this Component. 

Status Status of Component, such as Installed on Local Drive. 

Location Location on server where Component is installed. 

Verify Files Click to access the Files Dialog, where files in this Component that are either missing or 
have a different version or size than that specified in the MSI package are identified by the 
following icon: 5 
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Feature Properties Dialog 


The Feature Properties dialog is displayed when you select a Feature under the Deployment Status node and then 
select Properties from the context menu. 


Feature Properties 


General | 


Name: ProductFiles 

Title: Microsoft Office 

Parent: 

Description: Office programs, plus additional content and tools. 
Last Used: Wednesday, January 07, 2004 

Status: Installed on local Drive 

Usage Count: 4968 


OK Cancel Help 
FoR IN capes Of eee 


This dialog contains the following properties: 


Property Description 

Name Name of selected Feature. 

Title Title of selected Feature. 

Parent Parent Feature of this Feature (if one exists). 

Description Description of this Feature. 

Last Used Date this Feature was last used. 

Usage Count Number of times this Feature has been used. 

Verify Files Click to access the Files Dialog to verify the files in the selected Feature. 
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Install or Configure Feature Dialog 


The Install or Configure Feature Dialog is displayed when you select a Feature under the Deployment Status node and 
then select Configure from the context menu. 


Install or Configure Feature 


This will attempt to install or configure the selected feature to the 
settings you specify. To complete this operation, you may need the 
source From which the selected feature was installed, 


-Feature Settings ————— 


© Local (Files will be installed on the local machine} 


© Source (Files will be run from the installation source} 
© OnDemand (Files will be installed when needed) 


cot | e | 


If you select an option on this dialog and click OK, QualityMonitor will attempt to install or configure the selected 
Feature to the settings you specify. Select one of the following options: 


Default—Files will be installed to their default location. 


m Local—Files will be installed on the local machine. 


Source—Files will be run from the installation source. 


E On Demand—Files will be installed when needed. 


To complete this operation, you may need the source from which the selected Feature was installed. 
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Install or Configure Product Dialog 


The Install or Configure Product Dialog is displayed when you select the Deployment Status node and then select 
Configure from the context menu. If you select an option on this dialog and click OK, QualityMonitor will attempt to 
install or configure the Product to the settings you specify. 


Install or Configure Product 


This will attempt to install or configure the selected product to the 
settings you specify. To complete this operation, you may need the 
source From which the selected product was installed. 


r Product Settings 


Please select the new installation 


© Local (Files will be installed on the local machine) 
© Source (Files will be run From the installation source) 
© OnDemand (Files will be installed when needed) 


| 
Please select the new installation 


© Minimum (only the essential Features will be installed) 
© Typical (Most commonly used Features will be installed) 


Installation Location 
Select one of the following options: 


E Default—Files will be installed to their default location. 
m Local—Files will be installed on the local machine. 
E Source—Files will be run from the installation source. 


E On Demand—Files will be installed when needed. 


To complete this operation, you may need the source from which the selected feature was installed. 


Installation Type 


Select one of the following options: 


m Minimum— Only the essential Features will be installed. 
E Typical—Most commonly used Features will be installed. 


m Complete—All of the program's Features will be installed. 
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The Files dialog appears when you are using MSI Doctor to verify package deployment status, and you perform the 
following steps: 


E Go to the Deployment Status View and select either the Deployment Status node or one of the Features listed 
under it, and then 


m Select Properties from the context menu to display the Product Properties, Feature Properties, or Component 
Properties dialogs, and then 


m Click Verify Files. 


When you click Verify Files, QualityMonitor checks all of the files included in the selected Product or Feature and 
then displays them on the Files dialog. Files that are either missing or have a different version or size than that 


specified in the MSI package are identified by the following icon: w. 


E e a Component E 


C:\Program Files\Microsoft Office\Office10\Borders\MSART1.BDR MSART1.BDR Global_Word_WordBorders 32246 
C:\Program Files\Microsoft Office\Office10\Borders\MSART10,.BDR MSART10.BDR Global_Word_WordBorders 9292 

C:\Program Files\Microsoft Office\Office10\Borders\MSART11.BDR MSART11.BDR Global_Word_WordBorders 30920 
C:\Program Files\Microsoft Office\Office10\Borders\MS4RT12,.BDR MSART12.BDR Global_Word_WordBorders 58756 
C:\Program Files\Microsoft Office\Office10\Borders\MSART13.BDR MSART13.BDR Global_Word_WordBorders 28368 
C:\Program Files\Microsoft Office\Office10\Borders\MSART14.BDR MSART14.BDR Global_Word_WordBorders 51388 
C:\Program Files\Microsoft Office\Office10\Borders\MSART15.BDR MSARTIS.BDR Global_Word_WordBorders 27412 
C:\Program Files\Microsoft Office\Office10\Borders\MSA4RT2.BDR MSART2.BDR Global_Word_WordBorders 47188 
C:\Program Files\Microsoft Office\Office10\Borders\MSART3.BDR MSART3.BDR Global_Word_WordBorders 57646 
C:\Program Files\Microsoft Office\Office10\Borders\MSART4.BDR MSART4.BDR  Global_Word_WordBorders 14594 
C:\Program Files\Microsoft Office\Office10\Borders\MSARTS.BDR MSARTS.BDR Global_Word_WordBorders 15788 


o 
P 
o 
J 
P 
d 
4 
P 
4 
P 
Q 
< | 


Open QualityMonitor Project Dialog 


The Open QualityMonitor Project dialog appears when you select to open a QualityMonitor project from the 
Welcome page, or when you either select Open from the File menu or click the Open button on the toolbar. From 
this dialog, you can either select to open an existing QualityMonitor file (and subsequently enter or browse to it), or 
select to create a project file based on an installed MSI-based application. 
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Open QualityMonitor Project 
C Open QualityMonitor project igm) file 
S| 


@ Select an application that is installed on this machine from the Following list. This list shows 
installed products based on Windows Installer (MSI) technology. 


AdminStudio 5 Evaluation Guide 
B InstallShield AdminStudio 


| syInstallShield Developer 
F InstallShield Express 
{Bl Microsoft NET Framework (English) 
{Bl Microsoft NET Framework 1.1 
El Microsoft Office XP Professional 


MA Micrnentt \Mindewsic Teil Viewer 


ox | ea 


e e 
Options Dialog 
The Options dialog, available by selecting Options from the Tools menu, allows you to select whether you want to 
automatically update test case status after executing test items. If you do not use this functionality, the View List will 


not automatically update after a test item has been executed. 


Options 


JV Update the test case status automatically after executing test items 


Show Isolation Tests: 


[always X | 


Cancel | Help | 


4 


Additionally, you can choose when you would like to Show Isolation Tests after performing a Lockdown and 
Runtime test. You have the following options: 


m Always—Show this view for all the executables run, irrespective of the presence of records in the 
IsolatedComponent table and in MsiAssembly SXS records. 


m Never—This view will not be shown irrespective of the data. 


m Only if the Application is Isolated—Show this view only if the MSI Package has either IsolatedComponent 
records or MSIAssembly SXS records. 


= Only if the Running Operating System supports Isolation 
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AdminStudio always stores the information in the project but, the UI selection you make here determines whether this 
view will be populated. 


Product Properties Dialog 


The Product Properties dialog is displayed when you select the Deployment Status node and then select Properties 
from the context menu. 


Product Properties 


General | 


Version: 10.0.4330.0 

Publisher: Microsoft Corporation 

Product Code: {90110409-6000-11D3-8CFE-0050048383C9} 
Local C:\WINDOWS Installer] a4ed4.msi 
Registered To: InstallShield Software Corporation 

Product ID 54186-640-1985775-1 7073 

Status: The product is installed for the current user 
Help Link: http://www. microsoft.com support 

Installed on: 02-28-2003 

Installed from: DA 


OK | Cancel | Help | 


A 


This dialog contains the following properties: 


Property Description 

Version Product version. 

Publisher Manufacturer of Product. 

Product Code Number which uniquely identifies this Product. 

Local Directory on local machine where this MSI file is located. 

Registered to Registered user of Product. 

Product ID Status Installation status of this Product, such as "The product is installed for the current user." 
Help Link Main help link for the Product. 
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Property Description 

Installed on Date Product was installed. 

Installed from Location where Product was installed from. 

Verify Files Click to access the Files Dialog, where files that are either missing or have a different 
E or size than that specified in the MSI package are identified by the following icon: 


Re-install Product/Feature 


The Re-install Product/Feature Dialog is displayed when you select a Feature under the Deployment Status node or 
you select the Deployment Status node and then select Re-install from the context menu. 


Re-install Feature 


© Reinstall only if file is missing 
© Force all files to be reinstalled 
Additional Reinstall Modes: 
© Reinstall if file is missing, or an older version exists 
© Reinstall if file is missing, or an older or equal version exists 
© Reinstall if existing file has different version 
© verify that required user registry entries are present 
© Verify that required local machine registry entries are present 


C Recreate all shortcuts 


cancel | Heo | 


If you select an option on this dialog and click OK, QualityMonitor will attempt to reinstall the selected Feature(s) to 
the settings you specify. Select one option from the Select Reinstall Mode or Additional Reinstall Modes property: 


Property Description 


Select Reinstall Mode Select one of the following options: 
= Repair all detected reinstall problems 
= Reinstall only if file is missing 


= Force all files to be reinstalled 


Additional Reinstall Select one of the following options: 


Mode ra oaa ; 
= Reinstall if file is missing, or an older version exists 


= Reinstall if file is missing, or an older or equal version exists 
= Reinstall if existing file has different version 

a Verify that required user registry entries are present 

= Verify that required local machine registry entries are present 


= Recreate all shortcuts 
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Test Item Information Dialog 


The Test Item Information dialog is displayed when you right-click on a Test Item and select Test Item Information. 
From this dialog, you can see the name of the Test Item, its current status, any comments about it, and details if the 
Test Item has been executed. These details can include error messages generated during testing, which can help you 
diagnose issues with the package. 


E Test Item Information 


Test Item: | {00020423-0000-0000-C000-000000000046} 


Status: [X] Failed 7] 


Comments: 


Test Details: fyo such interface supported 


OK | Cancel | 


Test Progress Dialog 
The Test Progress dialog appears when you execute Test Items. 


Test Progress 


Testing File Associations: 1 of 1 - "wsa"... 


Click Run to execute the current test item. 


Skip Stop | 
A 


Note the following: 


E If you are performing Test Cases which have automatic execution (such as Type Libraries, Prog IDs, Services, or 
Class IDs), this dialog appears briefly and automatically closes when execution is complete. 


m For non-automatic Test Cases (Help Files, File Associations, and Shortcuts), this dialog appears for each Test Item 
selected, allowing you to run the test and perform any necessary manual actions. 


m Following execution of Test Items, the Test Result Dialog appears. 
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Test Result Dialog 


The Test Result dialog appears following execution of each Test Case requiring manual operations (Help Files, File 
Associations, and Shortcuts). 


E Test Result 


>) Did “wsa" Work Properly? 


Comment: 


You can enter Comments about the execution of the functionality, and click Yes or No depending on whether the 
Test Item passed. 


Views 


The following views are available in QualityMonitor: 


Product Information View 
The Product Information view displays information about the package you are testing in QualityMonitor. 


PackageForTheWeb 4 - InstallShield QualityMonitor 
File view Test Case Execute Tools Help 


KEA IERE E: 


peng ackageForTheweb 4 p= "Product Information 
Test Cycle Summary Product details 
=) Deployment Tests 


C ogy Class IDs 
g ix) File Associations Application Name: PackageForTheWeb 4 


C y) Prog IDs 
O E Shortcuts Author: InstallShield Software Corporation 


CW, Type Libraries 
E Lockdown and Runtime Tests 


ĝ User-Defined Tests Package Code: {5E6C9285-00E 1-4547-AB97-C2577E0ASF71} 


Product Code: {C9OCOAF 10-7B04-449E-9FAC-5436D2E238EC} 


Installed On: 07-14-2003 


Version: 4.0.0 
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Property 


Description 


Application Name 


The name of the application. 


Author 


The person or company who created the application. 


Product Code 


The package's product code. 


Package Code 


The package's package code. 


Installed On 


The date when the package was installed on the system. 


Version 


The package's version. 


In the View List, this view is titled with the product name. 
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Test Cycle Summary View 


The Test Cycle Summary view provides statistics on the number of Test Cases and Test Items in the QualityMonitor 
project, and the ratio of cases and items passed, failed, or pending. If you add additional Test Cases, or perform 
runtime checking, the number of Test Cases and items will increase. 


PackageFor TheWeb 4 - InstallShield QualityMonitor 
File view Test Case Execute Tools Help 


© h| a)! oe 
PackageForTheWeb 4 B 


E) Test Cycle Summary 
B ra Deployment Tests 
26 Class IDs 
File Associations Test Cycle Summary 
wf] Prog IDs 
E Shortcuts 
W Type Libraries 
‘@ Lockdown and Runtime Tests Total test cases: 5 Total test items: 7 
@ User-Defined Tests 


Test Cycle Summary 
Summary of all test cases 


Test Cycle Progress 


V] Passed: 0 (0%) V Passed: 0 (0%) 
X] Failed: 0 (0%) [X] Failed: 0 (0%) 


C] Pending: 5 (100%) Pending: 7 (100%) 


Test Cycle Items 


Deployment Tests Lockdown and Runtime Tests User-defined Tests 


2ĝy 1 Class IDs C] 0 Executables [3] 0 User-defined test cases 
[x] 1 File Associations E 0 Shortcuts 


W 3 Prog IDs 
E 1 Shortcuts 
Wa 1 Type Libraries 
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Deployment Tests View 
The Deployment Tests View provides a summary of all Deployment Tests. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Professional.iqm] DER) 
File view TestCase Execute Tools Help 


SH! 8% 
Microsoft Office XP Professional E] Deployment Tests 
S| Test Cycle Summary PRT Lists all the Deployment tests 
5 Deployment Tests 
of4y Class IDs 
ix) File Associations Deployment Tests Summary 
2 Help Files 
WW] Prog IDs 
E Shortcuts 
Es Type Libraries Total test cases: 7 


0 Fi ODBC Data Sources A passes 0 (0%) 
© Lockdown and Runtime Tests 


mE Microsoft Access x] Failed: 0 (0%) Execute All Deployment Tests | 
User-Defined Tests [C] Pending: 7 (100%) 
Deployment Status 


r Deployment Tests Progress 


Deployment Tests Items 


2 265 Class IDs 

(X) 78 File Associations 
(QB 21 Help Files 

\/) 288 Prog IDs 

31 Shortcuts 

E 80 Type Libraries 

Fl SODBC Data Sources 


Deployment tests help you with up to several Test Cases to run on your Windows Installer-based application. Tests 
are only available if the application has the corresponding associated data (for example, if there are no shortcuts, you 
cannot tun the Shortcuts Test Case). 


QualityMonitor includes the following deployment tests: 


Class IDs 

File Associations 
Help Files 

Prog IDs 

Services 

Shortcuts 

Type Libraries 
ODBC Data Sources 
ODBC Drivers 
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Automatically Running All Deployment Tests Silently 


You can choose to run all deployment tests silently (without prompting for user input) using either the Interface or 
the command line. 


From the Interface 


E To run all deployment tests silently from the Interface, do one of the following: 


m Select the Deployment Tests root node and then click the Execute All Deployment Tests button, displayed on the 
right side of the Deployment Tests View. 


m Select the Deployment Tests root node and then select Execute All Deployment Tests from the context menu. 
m Select All Deployment Tests from the Execute menu. 
@ Click the Execute All Deployment Tests toolbar button: 


[a 


When you select one of these options, a dialog with a progress bar and an option to cancel will be displayed. 
From the Command Line 


You can also run all deployment tests silently by entering a command in the command line. See Running 
QualityMonitor from the Command Line for more information. 
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Class IDs View 


The Class IDs view is the Test Case for class IDs in QualityMonitor. At the bottom of the view, you can see all Test 
Items associated with the Test Case, and can run these items either individually or simultaneously. You can also view 
individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, see Test 
Case progress, filter Test Item data, clear the results, or add comments. 


Paint Shop Pro 7 Anniversary Edition - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 


Gulgi:ae 


==) Paint Shop Pro 7 Anniversary Edition «ier Class IDs 
=) Test Cycle Summary BP) com class IDs test case details 
S| Deployment Tests 


oy Class IDs > Test Case Status —__ - Test Case Progress ——__ > Comments 
C] |x] File Associations 


Choose a status for the entire test Total test items: 27 


Help Files case 
Prog IDs v| Passed: 0 (0%) 


X| Failed: 0 (0%) 


C] EM Shortcuts @ Pending 
E Type Libraries 
@ Lockdown and Runtime Tests 


@ User-Defined Tests © Failed Sel 


Last Run At: 


© Passed 


Pending: 27 (100%) 


Test Items 


View these test items: | All x] Run all | Run | Reset Results 
| Status | Class 1D | Description | File Name 


Pending {2CF184C6-8253-11D3-9FD6-00500403FE36} HotLink Property Page C:\Program Files\Jasc Software 
Pending {336CE54F-8557-11D3-9FD6-00500403FE36} HotLink Control C:\Program Files\Jasc Software 
Pending {00020421-0000-0000-C000-000000000046} PSEnumariant C\WINDOWS\System32\oleaul 
Pending {00020422-0000-0000-c000-000000000046} PSTypelnfo C:\WINDOWS\System32\oleaul 
Pending {00020423-0000-0000-C000-000000000046} PSTypeLib CAAWINDOWS\System32\oleaul 
Pending {00020424-0000-0000-C000-000000000046} = PSOAInterface C\WINDOWS\System32\oleaul 
Pending {00020425-0000-0000-c000-000000000046} PSTypeComp C:\WINDOWS\System32\oleaul ¥ 


< ji | > 


[umf 2 
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File Associations View 


The File Associations view is the Test Case for file associations in QualityMonitor. At the bottom of the view, you can 
see all Test Items associated with the Test Case, and can run these items either individually or simultaneously. You can 
also view individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, 

see Test Case progress, filter Test Item data, clear the results, or add comments. 


Paint Shop Pro 7 Anniversary Edition - InstallShield QualityMonitor 


File View Test Case Execute Tools Help 


[Gala E 

Paint Shop Pro 7 Anniversary Edition 

=) Test Cycle Summary 

a Deployment Tests 

PT] Class IDs Test Case Status — > Test Case Progress ——_, Comments — 
Choose a status for the entire test Total test items: 7 
(= Help Files case 
Ww] Prog IDs V| Passed: 0 (0%) 
E Shortcuts — © Pendng | | 0 Failed: 0 (0%) 
W Type Libraries 
§@ Lockdown and Runtime Tests 


ail © Foled E 


Last Run At: 


C Passed 


Pending: 7 (100% 


Test Items 


View these test items: Z All ~] Run All | Run | Reset Results | 
File Extension | ProgID | Default verb 


Pending AnimationShop3. Animation open 
Pending AnimationShop3.\WorkSpaceFile open 
Pending PSP? Image open 
Pending PSP7, WorkSpace open 
Pending j PSP? BrowserFile open 
Pending mi PSP?, MultilmagePrint open 
Pending IMC. Document open 
< 
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Help Files View 


The Help Files view is the Test Case for launching help files in QualityMonitor. At the bottom of the view, you can 
see all Test Items associated with the Test Case, and can run these items either individually or simultaneously. You can 
also view individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, 
see Test Case progress, filter Test Item data, clear the results, or add comments. 


Microsoft Office XP Professional - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 
|S h|! ae 


Microsoft Office XP Professional Help Files 
8 Test Cycle Summary E Help Files 


=) jj Deployment Tests 
aĝ Class IDs m Test Case Status —— Test Case Progress p Comments 


_ Fic Associations Choose a status for the entire test Total test items: 21 

Help Files case 
WW] Prog IDs oe [V] Passed: 0 (0%) 
E Shortcuts + Pending Í 

X] Failed: 0 (0% 

W. Type Libraries (0%) 
ŞA ODBC Data Sources 
© Lockdown and Runtime Tests C Failed 


© Passed 


Pending: 21 (100%) 


ĝ User-Defined Tests 


Last Run At: 


Test Items 


view these test items: Z All >| 


Pending c:\program files\microsoft office\office10\cgmimp32.hlp 
Pending c:\program files\microsoft office\office10\1033\qrtip10.hip 
Pending c:\program files\microsoft office\office10\1033\msqry32.hlp 
Pending c:\program files\microsoft office\office10\1033\actip10.hip 


Nandina milmane Filacl-nrman Filactmicenqafh chavandlenanchat iinne am am in ble 


< i 
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Prog IDs View 


The Prog IDs view is the Test Case for prog IDs in QualityMonitor. At the bottom of the view, you can see all Test 
Items associated with the Test Case, and can run these items either individually or simultaneously. You can also view 
individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, see Test 
Case progress, filter Test Item data, clear the results, or add comments. 


PackageFor TheWeb 4 - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 
Gh S|: aH 
PackageForTheWeb 4 | Prog IDs 
S| Test Cycle Summary v Prog IDs test case details 
Hj Deployment Tests 


oy Class IDs Test Case Status ) Test Case Progress q] Comments 
|X] File Associations 


Choose a status For the entire test | Total test items: 3 


OW case | 
E Shortcuts | M] Passed: 0 (0%) 
W\ Type Libraries (© Pending 
© Lockdown and Runtime Te 

@ User-Defined Tests LJ 


X] Failed: 0 (0%) 


© Passed 


C] Pending: 


C Fale [<i 


Last Run At: 


Test Items 


View these test items: | All x] Run All | Run | Reset Results | 
Ee E 0S = A ESA 


Pending PFWServer.PFWFile. 1 PFWFile Class C:\Program Files\InstallShield\PackageForTheWeb 4\PFWServer.dll {032E444 
Pending PackageForTheWeb, Project. File C:\Program Files\InstallShield\PackageForThe web 4\pftwwiz.exe — 
Pending PFWServer.PFWFile PFWFile Class C:\Program Files\InstallShield\PackageForTheWeb 4\PFW Server dll 


| v 


C wml 
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Shortcuts View 


The Shortcuts view is the Test Case for shortcuts in QualityMonitor. At the bottom of the view, you can see all Test 
Items associated with the Test Case, and can run these items either individually or simultaneously. You can also view 
individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, see Test 
Case progress, filter Test Item data, clear the results, or add comments. 


PackageFor TheWeb 4 - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 


|© kh0! 8 Y 
PackageForTheWeb 4 Shortcuts 
©) Test Cycle Summary Shortcuts 
=) Deployment Tests 
oy Class IDs Test Case Status Test Case Progress 
a File Associations Choose a status for the entire test Total test items: 1 
Prog IDs case 
a reni | Passed: 1 (100%) 
W\ Type Libraries ending REE 
@ Lockdown and Runtime Te Ba Failed: ooy 
ĝ User-Defined Tests 


r Comments 


ogoogo 


@ Passed 


Pending: 0 (0%) 


C Fated A 
| 


Last Run At: 07-14-2003 02:39:08 PM 


Test Items 


View these test items: Z All ~] Run All | Reset Results | 
Eea E e A 


Passed PackageForTheWeb 4 :\Start Menu\Programs\InstallShield\PackageForTheWeb 4.Ink 
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The Type Libraries view is the Test Case for type libraries in QualityMonitor. At the bottom of the view, you can see 
all Test Items associated with the Test Case, and can run these items either individually or simultaneously. You can 
also view individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, 


see Test Case progress, filter Test Item data, clear the results, or add comments. 


PackageForTheWeb 4 - InstallShield QualityMonitor 
File View Test Case Execute Tools Help 


|S h0! 8 Y 
] PackageForThewWeb 4 
=) Test Cycle Summary 
H | Deployment Tests 
O eg Class IDs 
O x) File Associations 
C vy) Prog IDs 
vi Æ Shortcuts 


28 is Type Libraries 


Type Libraries 
Type Libraries test case details 
Test Case Status 


Choose a status For the entire test 
case 


© Pending 


Test Case Progress 


Total test items: 


v| Passed: 


[X] Failed: 


1 
1 (100%) 
0 (0%) 


r Comments 


© Lockdown and Runtime Te 
@ User-Defined Tests Passed v] 


C Pending: 0 (0%) 


© Failed 


Last Run At: 07-14-2003 02:41:48 PM 


Test Items 


View these test items: [za All >| Run all | Reset Results | 
| Status | Typelibrary | Description | File Name 


Passed {032E443F-4FA7-11D5-852B-00B0D023B20D} PFWServer 1.0 Type Library C:\Program Files\InstallShield\PackageForTheWeb 
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ODBC Data Sources View 


The ODBC Data Sources view is the Test Case for ODBC data sources in QualityMonitor. At the bottom of the 
view, you can see all ODBC DSNs associated with the Test Case, and can run these items either individually or 
simultaneously. You can also view individual Test Item details. At the top of the view, you can see and set the status 
of the entire Test Case, see Test Case progress, filter Test Item data, clear the results, or add comments. 


Microsoft Office XP Professional - InstallShield QualityMonitor 


Microsoft Office xP Professional _§ ODBC Data Sources 

=) Test Cycle Summary ` ODBC Data Source 
= Deployment Tests 
of Class IDs -Test Case Status — p Test Case Progress > Comments 
X] File Associations Choose a status For the entire test Total test items: 5 

Help Files case 
Ww] Prog IDs on V| Passed: 0 (0%) 

+ Pending 

E Shortcuts — X] Failed: 0 (0%) 
Ws Type Libraries 


Pra ODBC Data Sources O Passed Pending: 5 (100%) 
© Lockdown and Runtime Tests C Failed | 
ĝ User-Defined Tests 


Last Run At: 


Test Items _ 


View these test items: Z All >| Run All | Run | Reset Results | 
| Status | Data Source Name DSN Type 


Pending Excel Files Microsoft Excel Driver (*.xls) User 
Pending MS Access Database Microsoft Access Driver (*.mdb) User 
Pending Visual FoxPro Database Microsoft Visual FoxPro Driver User 
Pending Visual FoxPro Tables User 


Nandina ADACE Cila- i heme 


4 jii 


On the ODBC Data Sources View, only those data sources that belong to the current logged-in user are listed. 


For certain ODBC data sources, additional connection information is required for verification. When the tests are run in 
Full user interface mode, additional dialogs may be displayed during the test to take more input. However, when the 
tests are run in Silent user interface mode, these additional dialogs will not be displayed and results will be based on 
default information. 
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ODBC Drivers View 


The ODBC Drivers view is the Test Case for ODBC drivers in QualityMonitor. At the bottom of the view, you can 
see all ODBC drivers associated with the Test Case, and can run these items either individually or simultaneously. You 
can also view individual Test Item details. At the top of the view, you can see and set the status of the entire Test 
Case, see Test Case progress, filter Test Item data, clear the results, or add comments. 


Crystal Reports - InstallShield QualityMonitor [C:\AdminStudio Shared\Crystal Reports.iqm] DER) 
Fie View TestCase Execute Tools Help 


AAE E 


Crystal Reports H! ODBC Drivers 
=) Test Cycle Summary “A ODBC Drivers test cas 
A 5 Deployment Tests 

ogy Class IDs Test Case Status Test Case Progress ———————._ - Comments 


File Associations Choose a status For the entire test Total test items: 7 
Help Files case | 


Prog IDs 5 d | V] Passed: 0 (0%) 
© Pending | 

L El Shortcuts — X) Failed: 0 (0%) 

W\ Type Libraries 


a) ODBC Drivers © Passed Pending: 7 (100%) 
dca en tae © Faled SSS 
3E Lockdown and Runtime Tests 


& User-Defined Tests 


Last Run At: 


Test Items 


View these test items: Z All x] Run All | Run | Reset Resuts | 


Eae A 
Pending CR DB2 CAWINDOWS\System32\Crdb2 1 4.dll 

Pending CR Informix CA\WINDOWS|System32\Crinf14.dll 

Pending CR Informix9 CA\WINDOWS|System32\Crinf914.dll 

Pending CR Oracle? C\WINDOWS\System32\Cror? 14.dll 

Pending CR Oracles v3.6 CAAWINDOWS\System32\CROR815.DLL 

Pending CR Sybase System 10 C:\WINDOWS\System32\Crsyb14.dll 

Pending CR XML v3.6 CAAWINDOWS\System32\CRXML15,DLL 


< M 


On the ODBC Drivers View, only those drivers that belong to the current logged-in user are listed. 


For certain ODBC drivers, additional connection information is required for verification. When the tests are run in Full 
user interface mode, additional dialogs may be displayed during the test to take more input. However, when the tests 
are run in Silent user interface mode, these additional dialogs will not be displayed and results will be based on default 
information. 
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Services View 


The Services view is the Test Case for NT Services in QualityMonitor. At the bottom of the view, you can see all Test 
Items associated with the Test Case, and can run these items either individually or simultaneously. You can also view 
individual Test Item details. At the top of the view, you can see and set the status of the entire Test Case, see Test 
Case progress, filter Test Item data, clear the results, or add comments. 


Symantec AntiVirus Client - InstallShield QualityMonitor [C:\AdminStudio Shared\Symantec AntiVirus Client.iqm] 
File view Test Case Execute Tools Help 


CAIFE aH 


Symantec Antivirus Client is. Services 

S| Test Cycle Summary H Services test case details 

S| Deployment Tests 

of Class IDs Test Case Status > Test Case Progress Comments - 
Help Files Choose a status for the entire test Total test items: 3 
Prog IDs case 
i V| Passed: 0 (0%) 

Shortcuts @ Pending 

E» Type Libraries 

@ Lockdown and Runtime Tests Passed LI C] Pending: 3 (100%) 


X] Failed: 0 (0%) 


@& User-Defined Tests C Failed m 


Last Run At: 


Test Items 


View these test items: Z All >| Run all | Run | Reset Results | LJ 


ee eee SC ae ae ec 


Pending Symantec Antivirus Client 
Pending NAV¥APEL 
Pending DefWatch 


< 
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Lockdown and Runtime Tests View 


From the Lockdown and Runtime Tests view, you can select whether you want to perform runtime checking using a 
shortcut or an executable in the installed package. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Professional.iqm] DER 


Fie view TestCase Execute Tools Help 


CAIRE S 
E- Microsoft Office XP Professional = Lockdown and Runtime Tests 
=| Test Cycle Summary i Perform runtime checks by selecting an executable or shortcut 
a Deployment Tests 


C ogy Class IDs 


X) File Associations Select a shortcut or executable from the Following list. The selected item will be launched and monitored during its 
execution, If there are any errors, they will be reported after the execution ends, 


Help Files 


W] Prog IDs 
E Shortcuts 
Es Type Libraries 


C 8A ODBC Data Sources Shortcut Name 


“© Lockdown and Runtime Tests Microsoft Office Document Imaging C:\Program Files\Common Files\Microsoft Shared\MSPaper\MSPYIE— 
8 User-Defined Tests Microsoft Access C:\Program Files\Microsoft Office\Office10\MSACCESS.EXE 
Microsoft Outlook C:\Program Files\Microsoft Office\Office10\OUTLOOK.EXE 
Save My Settings Wizard C:\Program Files\Microsoft Office\Office10\PROFLWIZ.EXE 


RAL ae ak Mae eaten ND mnene Mile AURA me ak AEC: e LACE: Cena cur 


< ml | > 


OOOO! 


© Select an Executable 


Executable Name 

c:\program files\microsoft office\office10\msqry32.exe 

c:\program files\common Files\system\mapi\1033\ml3xec16,exe 
c:\program files\microsoft office\office10\1033\schdpl32.exe 
c:\program files\microsoft office\office10\nsrex.exe 

c:\program Files\common files\microsoft shared\msinfo\offprv10.exe 
rinranram fileciramman Filecimicrnenfh charedimenanerimenviem eve 


You can select an item in the associated list and click Run to launch the application. After exercising the application's 
functionality and closing it, additional views will appear associated with the executable. These views initially display 
test items that failed during application operation, and are grouped into Files, Folders, Registry Entry tests, and 
Isolation Tests. 


If you want to execute tests in the context of a different user (under a different user account), click Run As. For more 
information, see Performing Lockdown and Runtime Tests Under a Different User Account. 


Lockdown and runtime checks cannot be performed on Windows 9x-based systems. 
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Isolation Tests View 


You can run Isolation Tests to display the location of all PE files (dll/ocx/exe/tlb/olb) that are launched from a 
process while performing a Lockdown and Runtime test. Viewing a listing of these PE names and paths makes it 
easier for you to ensure that the application is fully isolated. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Wicrosoft Office XP Professional.iqm] DER) 


File Yiew TestCase Execute Tools Help 


CA IE ae 
E- Microsoft Office XP Professional Isolation Tests 
=} Test Cycle Summary 5 Verify Application's 
z 5 Deployment Tests 
oy Class IDs Test Case Status —-——————— ) r Test Case Progress Comments 
X] File Associations Choose a status for the entire test Total test items: 33 
Help Files case 
Prog IDs vi Passed: 0 (0%) 
El Shortcuts © Pann 5] Failed: 0 (0%) 
W Type Libraries 
i ODBC Data Sources 
H- Lockdown and Runtime Tests C Failed 
=] By Microsoft Access 
XA Registry Entries 
€ Isolation Tests 
B 8 User-Defined Tests 
(8) Test Case Test Items 
B fea Deployment Status 
H-E ProductFiles 
+) 9 OfficeUserData 
+) 9 AlwaysInstalled 
H-E HiddenFeatures 
© WebPublFiles 


C Passed 


Pending: 33 (100% 


Pending SKCHUI.DLL C:\Program Files\Common Files\Microsoft Shared\Ink\, 
Pending mso.dll C:\Program Files\Common Files\Microsoft Shared\office10\, 
Pending riched20.dll C:\Program Files\Common Files\Microsoft Shared\office10\, 
Pending msain.dil C:\Program Files\Microsoft Office\Office 1041033), 
Pend srintl.dll C:\Program Files\Microsoft Office\Office 1041033), 
MSACCESS,EXE C:\Program Files\Microsoft Office\Office 10), 
msostyle. dll C:\Program Files\Microsoft Office\Office10\, 
SPGRMR.DLL C:\WINDOWS\IME}, 

ling CLBCATQ,DLL C:\WINDOWS|System32\, 
Pending COMRes.dll C:A\WINDOW'S\System32\, 
Pending MSCTF.dll C:\WINDOWS\System32\, 
< 


After you perform a Lockdown and Runtime Test for an executable (EXE) or a shortcut on the Lockdown and 
Runtime Tests view, an additional node called Isolation Tests is added to the tree under the executable or shortcut 
node. When you select this Isolation Tests node, the filenames of the PE files and their paths is displayed in the list 
control of the view. By default, the status of all these items is Pending. To ensure that all of the executables or 
shortcuts in this test case are isolated, go to the Test Case Status area of the view, and set the status of the entire test 
case to either Pending, Passed, or Failed. 


The Isolation Tests node will be added to the Lockdown and Runtime Tests tree only if the selected executable launches 
at least one PE file. 
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You can specify when you would like the Isolation Tests node to be added by going to QualityMonitor's Main Menu 
and selecting Options from the Tools menu, and then selecting an option from the Show Isolation Tests list. 


QualityMonitor does not support isolation testing under Windows 2000. 


User-Defined Tests View 


As your business practices dictate, you can add additional, custom tests to the QualityMonitor project file. This is 
accomplished by right-clicking on the User-Defined Tests view and selecting Add Test Case. 


Paint Shop Pro 7 Anniversary Edition - InstallShield QualityMonitor DAR 
Fie View TestCase Execute Tools Help 


ShA: ey 


Paint Shop Pro 7 Anniversary Edition User-Defined Tests 

=| Test Cycle Summary Nb Summary for user-defined test cases 
S| 5 Deployment Tests 
ogy Class IDs 
x) File Associations User-Defined Tests Summary 
(=) Help Files 
Prog IDs 
E Shortcuts 
CIM Type Libraries Total test cases: 0 
© Lockdown and Runtime Tests 
@ User-Defined Tests 


IO O&O 


m User-Defined Tests Progress 


vV Passed 0 (0%) 


X] Failed 0 (0%) 


C] Pending 0 (0%) 


User-Defined Tests Tasks 


El Add a user-defined test case 
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Test Case View 


When you select a user-defined Test Case under User-Defined Tests on the View List, the Test Case View opens. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Wicrosoft Office XP Profe... DER) 
File Yiew Test Case Execute Tools Help 


[Sh g: aS 


Microsoft Office XP Professional Test Case2 

©) Test Cycle Summary D Details for this user-defined te: 
=] 5 Deployment Tests 
of4y Class IDs m Test Case Status 
x] File Associations 


Choose a status for the entire test 


Help Files case 
J] Prog IDs 
Shortcuts @ Pending 
OW, Type Libraries 
ŞA ODBC Data Sources 
=) Lockdown and Runtime Tests C Failed 


© Passed 


H-E Microsoft Access 
X] |_) Files 
X a Registry Entries . 
B 8 a Tests Instructions: 
(3) Test Casel 
a 
=| fey Deployment Status 
H-E ProductFiles 
H-E OfficeUserData 
|) AlwaysInstalled 
(+) 9 HiddenFeatures 
E WebPublFiles 


This view contains the following properties: 


Property Value 


Test Case Status Specify the status of the selected Test Case by selecting one of the following options: 


= Pending-—Test case has not been executed. 
= Passed—Test case has been executed and has passed. 


= Failed—Test case has been executed and has failed. 


Instructions Enter any necessary comments. 
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Deployment Status View 
The Deployment Status View lists all of the products and features in the MSI package. 


Microsoft Office XP Professional - InstallShield QualityMonitor [C:\AdminStudio Shared\Microsoft Office XP Professio... [E \(E|[K] 


File Yiew Test Case Execute Tools Help 


|@eu|ga\!' ae 


Microsoft Office XP Professional 


Lal Deployment Status 


2) Test Cycle Summary 
E Deployment Tests 


© Lockdown and Runtime Tests 


BY Microsoft Access 
User-Defined Tests 
Deployment Status 

| 9 ProductFiles 

=| OfficeUserData 

E AccessUserData 
E ExcelUserData 
E OutlookUserData 


© List of all the components in the MSI package 


Component Name 

Global_Jet_Replication 
Global_PowerPoint_PowerCastNetShowS¥R 
Global_MediaStore_Core 
skchui.dll.9846701C_B1E3_426B_BC32_969244645947 
Global_Access_SnapshotSys 
msb1xtor.dll,B0462459_943D_460D_BFD4_D367D28FAEED 
Global_Access_SnapshotCore 

AllOtherFiles. AF4O44F8_9187_4E0C_A423E_344075B53E7C 


Installed on local Dri 
Installed on local Dri — 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 


E PowerPointUserData 
E WebDriveUserData 
€ WordUserData 

H-6 AlwaysInstalled 
E opcRemovePreviousMax 
E OPCRemovePreviousMin 
9 AlwaysHelper 
&Ə Officalinternal 
3) ShortcutSupport 

=| 9 HiddenFeatures 
9 SpeechHidden 
© TranslationHidden 
E HandWritingHidden 

3 WebPublFiles 


Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Installed on local Dri 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed 


Not installed Mi 
> 


[hal 7 


AllOtherFiles.BO6CDA94_77FD_4E8C_A601_07525A7F758E 
AutoCorrectLists.DODF3458_A845_11D3_8D04_0050046416B9 
AutoCorrectLists_1036,DODF3458_4845_11D3_8D04_0050046416B9 
AutoCorrectLists_3082,D0DF3458_4845_11D3_8D04_0050046416B9 
CS55Pkg_Reg,_MSE.3643236F_FC70_11D3_A536_0090278A41BB8 
C55_Package_ENU_X86.3643236F_FC70_11D3_A536_0090278A1BB8 
C55_Package X86, 3643236F_FC70_11D3_A536_009027841BB8 
C_TermServerRegistry.4373E4B3_7A87_11D3_B1C1_00CO4F68155C 
C_athprxy_dll.4373E4B3_7A87_11D3_B1C1_00C04F68155C 
C_dsscntrs_h.A373E4B3_7A87_11D3_B1C1_00CO4F68155C 
C_dsscntrs_ini.A373E4B3_7487_11D3_B1C1_o0Co4F68155¢ 
C_Ftsqlpar_dll.A373E4B3_7487_11D3_B1C1_o0Co4F68155¢ 

C nathrnem txt. ARS7AF4R3 aag RIC1 NNCN4FARISSC 


Axxxxxx0 00000000000000 


Products and features in the MSI package are listed in the Deployment Status tree, with an icon indicating its status: 


= installed 
x not installed 
6 akey file is either missing or does not match the version or size of that file recorded in the MSI file 
When you select the Deployment Status node, all of the components in all of the product features are listed on the 


right. If you select an individual feature, only those components within that feature are listed. The following 
information is displayed: 


Property Description 


Component Name Name of all components in the MSI package or selected feature. 


Status of the listed component: either installed &, not installed X, or @ a key file is either 
missing or does not match the version or size of that file recorded in the MSI file 


Component Status 


Component Location Location of installed component. 


Component ID GUID of the component, which uniquely identifies it. 
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Best Practices for Conflict Detection OO OOOO OO OS OOOO COOL OOOO OOS OOOO OOOS OOOO OOOO OOOS OOOO OOO OOOO OOOO OOOEOS 660 


Plan Your IMport...........ccccccccccccccccccccccecccccccecccceccecccscccecccseccecccceccececcscccccccsccccccccsccsccscsccccccccccecccseceeees OO I 


Check and Configure Your Import Options ..........::cscecssecseeereesseeseceeesseeveessseceeeeseesneesiresereseieeeaeeeeenteesneesntenes 661 
Use the Command Line / Bulk Import Option of ConflictSolver.........cccecceeceeeneeneeenseceseeneeneeenreentecnreseeeetteseeeaes 662 


Plan Your Conflict Detection.......ccccccscccssccssccssccccccesccesccescccsccssccssccssccsccesccescccsccsscceccceccceccceccscccsecesccesss OOS 


Perform Conflict Detection on Internal Application Catalog Packages .........::ssccsseeseeseesecsseceeesitesntessreseaeestennte 663 
Check and Configure Your Conflict Options .........:ccccceseeereceresseeececeneesneeeneesssesseeeeeecneecneesereseeeeeeeetesteesneestenas 663 


Perform Conflict Detection ......cccccocccssccccccssccssccssccsscccsccssccssccsscsscccsccsscccsccesccscccescccccccccsccccccscccscccsscsess OOF 


Pre-Contflict Detection Planning sesiis irrst tiers iter Ror iair ree Eia NEE EA ATETA TOKET ONOARE EEN EAE EANET 664 
Conflict Detection Processing ..........cs:ccesseceeeseeeeseeeeeceeeeeeseeeeceseeeneeseeeeseseeseneeseseseeaeeeceeeenseeceieesetseeseieeseteeees 665 
Post-Conflict Detection Evaluation .........c..cccccccccssseeecccccceceueeeececcccceuuuaeeceececseeuauseeececcseusuanenececcceseuuaaaeeseceeeuaaaneess 665 


Managing COmnPliCtSOlWe iiss sss cdssssccisscceissicsebcccocsccccscsscdosdescosescdocscosdeesoscoecsscsesss 666 


Connecting to Existing Application Catalogs ............ccccccccccccsccccscsccsccccccsccccccccscccccccscccccccscccccccsccceeeees OOO 
User Permissions in ConflictSolver .............ccccccccccccscccccccsccccccccccccccccccccccccccccceccccecceccsccscecccsssccccssssescees OOD 
ConflictSolver Grouping. ..........cccccccccccscccccccccccccccccccccccccccccsccccsccccccccsccccccsssccccccsccccccccccccccccssscccsccssecces OOD 


Organizing Products in ConflictSolver.........:eccseceesseeessecsseessecseeeeecensesseeensecsseseeeeneecneeseeseaeseteeeneeneeseesteesntenss 669 
AddingrContlictSolver‘ Groupsictncictisetstadexvssscaiseclecen adh skshds caxeeesptesdepeeteaton she Ooudersaveghessalabepsiesaaseulsageee eeeases 670 
Deleting ContlictSolver Groups: isisisi esnie iati E seeaidecusass ducing seeceniaveicusases sauces desecasapenarvanes 671 
Editing: Group Properties aaaeei naona SRE EE S ENA EEAS OEE pis EASE A Siew dant gt ead 671 
Copying Packages to Multiple ConflictSolver Groups........c:ccesecssecereeeeresereeerecsresseeeeaeeeeecneesneesneeseeneesneeenrenntenes 672 
Moving Products, OS Snapshots, and Groups.......ssccsesseestessresseeececeeecseeeneeeeseceseceesneesnseseseseecensesntesntesneesntesas 672 
Extended Attributes.........ccccscssssorsssccsssscssccrssccccssssecccssccccessoocescesesscccesscsesesscccccesssccsssseccccsssosssoosssssees 67 3 
Using Extended, Attri butesijsc.iccsvasteuxdeds steste sncedicnssnceceiven a a T a hepabedecrtoutees dean tae Gates 674 
Extended Attribute Description File ...........:eccesscesseeseeeseeesseeeeeeeecseeceressaeseeesnsesaeecnsesneeeneeeetecttesntesstessaeeeneeenee 675 
Extended Attributes’ and AMS seats sessaisxezccayaveutedusneudenukexssdescuaacayedevcveunecubapnascesenauceudbeeusduapnyaneuabanesadvaseessartie® 677 


Deleting Packages. ...........ccccccccccccscccccccccccccccccccccccccccccccccccccccccccceccccccceccccccceccccescecccceccccccseccccccsscceeees ÓZ S 
Purging Conflict Information from the Application Catalog ...........ccccccccecccccsssscssccccccccssceccsccccsesseees 67 S 
About the ConflictSolver Application Catalog Database .............cccccccsccsccccsccscccccscscccccccccccccccscccccccscees OD 
Searching the Application Catalog..............cccccccccsccccsccscccccsccccccccccccsccccccscccccccscccccccsccccccsccscccssceseesers OOO 
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About the ConflictSolver Database Scheima.......cccccccocccscsccccccscccssccssccsscssscssccesccsccesccscccscccsccccccesccsesss OOD 


cssys: ConflictSolver System Tables rosier nina deeb ancl A R ESEA NEE E 684 
estbl? ConflictSolver Supporting Tablesisiessseenirnisiienieensne iie staneccubouay lan shebudaeussaaeaeibschbdebateedhbduncedapevcelunt sues 687 


Importing Data SOOO OOS OOOO OOOO OOOS OOOO OOOSOOOS OOD SOO OOOSOOOS OHSS OOOH OHSS SOS OOHS OOOH OOOH OOOH SOSH OOOH OOOOOOO®S 701 


Supported Import Types ..........ccccccccccccccccccccccccccsccccccccscccccccccccccsccccccesccccsccscccesccscccescccccccscssccscscsscccces ZOT 


Windows Installer (.msi) ...........ccceccceescceeeeceenceeeeeeeeeeeeeeeeeeeeeeeaeeeneeseeeeecseeseaeeeneeeceeeeeeeecsseeeceeseneeesiseseneeees 702 
MROMSFOMS! | HSH) eae oeer sau AE E R tas etn sees AT saucers EEE easiest -aeuteeeeacseacetay 702 
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ConflictSolver is included with AdminStudio Professional Edition. 


Although a Windows Installer package or merge module may be built to guidelines put forth by Microsoft, it is 
possible that the interaction between packages, or between a package and the base operating system, may cause 
unwanted results in your production environment. ConflictSolver enables you to identify these conflicts before you 
deploy packages, and resolve the problems before they affect your end users. 


ConflictSolver allows you to check for a variety of conflict types, including file, component, and registry conflicts. In 
many cases, ConflictSolver can resolve the issues automatically. You can also create your own custom rules to ensure 
packages conform to your internal standards and practices. ConflictSolver has rules to detect conflicts involving: 
Components, Files, Registry Entries, Shortcuts, INI Files, ODBC Resources, NT Services, File Extensions, and 
Product Properties. 


The ConflictSolver Online Help Library is organized into the following areas: 


ConflictSolver Online Help Library 


2) Managing ConflictSolver 


This section covers management tasks such as connecting to Application Catalogs, searching an Application 
Catalog, and organizing packages in ConflictSolver into groups. 


2) Importing Data 


ConflictSolver supports the import of Windows Installer packages (.msi) with any associated transforms (.mst) 
or patches (.msp), merge modules (.msm), OS snapshots (.osc), Marimba NCP files (.ncp), and other setup 
types. This section provides step-by-step instructions on how to import data into ContflictSolver. 


Merging Application Catalogs Using the Merge Wizard 


© 


You can use the Merge Wizard to merge data from a source Application Catalog into the currently open 
Application Catalog. (For a comparison of the three methods for sharing Application Catalog Data in 
AdminStudio, see Sharing Application Catalog Data.) 


Using Remote Package Alert to Link to Remote Application Catalogs 


© 


You can use the Remote Package Alert feature to link to MSI packages in a remote Application Catalog, 
import the data into your local Application Catalog, and maintain consistency between the packages. (For a 
comparison of the three methods for sharing Application Catalog Data in AdminStudio, see Sharing 
Application Catalog Data.) 


©) Validating Packages 


Optimally, packages should pass ICE validation. Topics in this section instruct you how to perform validation, 
and what to do if it fails. 
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ConflictSolver Online Help Library 


& 


Identifying and Resolving Conflicts 


ConflictSolver's core purpose is to help you identify and resolve application conflicts. Topics in this section 
show you how. 


© 


Generating Reports 


You can generate included or custom reports using ConflictSolver. 


G 


Application Conflict Evaluators (ACEs) 


ConflictSolver includes many rules that are used for identifying package conflicts. This section covers each 
rule, and also discusses how to create your own rules. 


© 


Conflict Application Resolution Definitions (CARDs) 


Conflict Application Resolution Definitions (CARDs) are the rules used to fix conflicts identified by Application 
Conflict Evaluators (ACEs) when conflict detection is performed. 


© 


Command-Line Functionality 


ConflictSolver is completely command-line enabled. Learn how to take advantage of this built-in functionality. 


€ 


ConflictSolver Reference 


Every view, dialog, and Wizard available in ConflictSolver is discussed in this section. 


€ 


Taking OS Snapshots 


In addition to using packages for conflict identification, you can also use OS snapshots. This section covers 
how to create them. 
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Best Practices for Conflict Detection 


When using ConflictSolver, the most database-intensive (and therefore most time consuming) tasks that you perform 
are importing packages and performing conflict detection. The time needed to complete these tasks depends upon 
how you have configured ConflictSolver and the steps that you follow. To ensure optimal performance of 
ConflictSolver during package import and conflict detection, we recommend that you incorporate the following best 
practices: 


= Plan Your Import—lIf you are not using user-defined ACE rules, specify that you do not want to import binary 
data and custom tables. Also, specify that you do not want to check for validation errors or conflicts during 
import, and use the bulk import command line process. 


= Plan Your Conflict Detection—Perform conflict detection on internal packages only, and limit the scope of 
conflict detection by choosing to run only the ACEs that are relevant to your organization. 


= Perform Conflict Detection—Follow this sequence of steps to quickly and efficiently perform conflict 
detection. 
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Plan Your Import 


Check and Configure Your Import Options 


Before initiating an import, you should review the following options on the Import Tab of the ConflictSolver Options 
dialog: 


Options 
-Extended Attributes o || Duplicate Package _ 
General | Import | Validate || Resolution || Conflicts 
Options 
Check for Validation Errors 
Import Binary Data 
Import Custom Tables 
C] Abort on Fatal Error 


Ignore T ables 


Table Name Comments 


= Import Binary Data & Import Custom Tables—If you do not expect to run user-defined ACE rules, then 
you do not need to import either binary data or custom tables. 


m Check for Validation Errors & Check for Conflicts—Checking packages for validation at the time of 
import is often unnecessary. Also, conflict detection at the time of package importation will become an 
exponentially slow operation as the size of your Application Catalog increases, since this option causes the package 
to be conflict checked against all existing packages in the Application Catalog. 


Generally, unless it supports some specific business case, deselect the five import options on the Import Tab of the 
ConflictSolver Options dialog. 
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Use the Command Line / Bulk Import Option of ConflictSolver 


ConflictSolver supports a bulk import process, which allows you to import multiple installer packages (such as MSI, 
MSM, MST, MSP, OSC and NCP files) at once without any user intervention. You can set up these files and have 
them run overnight or on an unattended workstation. By doing this, you minimize the need for someone to monitor 
the import process, freeing that person up to perform other tasks. 


Also, if you use Bulk Import to import packages before they have been conflict checked, ConflictSolver performance 
is improved because it is quicker to perform conflict detection between internal installation packages than between 
internal packages and an external MSI package. 


Performing a Bulk Import 


To perform a bulk import, use the following command line: 


iscmide.exe -I -C"c:\mypackages\myconfig.ini" 


If you are using a configuration file, the only necessary parameters to pass at the command line are -I and - 
C"configuration_file_name.ini". You can include all other parameters inside the INI file. The following INI file is 
used to import packages into an SQL Server Application Catalog for a named user: 


[General ] 

DatabaseType=SQL 

LogFi le=c:\temp\importlog.txt 
MSIFi le=3 

MSMFi le=1 

[SQL] 
Server=ConflictSolverSQL2K 
UserID=Admin 
Password=mypassword 
Database=AdminStudio50 

[MSIFi le-1] 

Fi le=\\server\Datal.msi 
Transforml=\\server\Datala.mst 
Transform2=\\server\Datalb.mst 
Group=OFfficeApps 

[MSIFi le-2] 

Fi le=\\server\Data2.msi 
Group=Of fi ceApps\Secondary 
[MSIFile-3] 

Fi le=\\server\Data3.msi 

[MSMFi le-1] 

Fi le=\\server\CrystalReports.msm 


For more information on command line options, see Command-Line Functionality and ConflictSolver Configuration 
File. 
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Organizing Your Bulk Import 


If a package has not been conflict checked, import it into a "quarantine" (working) group, check it for conflicts, and 
only move it into another group when it is free of conflicts. For purposes of conflict detection, you would not use any 
of the other packages in this quarantine group as one of the target packages because they are still in the process of 
being analyzed for conflicts against the rest of the Application Catalog (potentially by other users). 


Plan Your Conflict Detection 


Perform Conflict Detection on Internal Application Catalog 
Packages 


Checking for conflicts against external MSI packages is much slower than checking against a package already imported 
into the Application Catalog. Therefore, we recommend that you import all packages that you want to conflict check 
into the Application Catalog and select the Internal Application Catalog package option on the Source Type Panel of 
the Conflict Wizard. 


Check and Configure Your Conflict Options 


ConflictSolver includes over twenty Application Conflict Evaluators (ACEs)—tules that allow ConflictSolver to 
identify conflicts between setups and between setups and operating system images. 


Before beginning conflict detection, review the purpose of each of the ACEs. Then, on the Conflicts Tab of the 
Tools | Options dialog, select only those conflicts that are appropriate for the packages you are checking. By limiting 
the scope of conflict detection, you will be improving the performance of the conflict detection process. 


For a description of all ConflictSolver ACE rules, see Application Conflict Evaluators (ACEs). 
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Perform Conflict Detection 


To ensure optimal performance of ConflictSolver during conflict detection, perform these steps in the following 
sequence: 


Pre-Conflict Detection Planning 


2 


ri 


To perform pre-conflict detection planning 


1. Create a new SQL Server database using the Create option on the AdminStudio Interface Catalog 
menu. See Creating a New Application Catalog. 


2. Configure the user permissions on this database through the Workflow menus, using the User option on 
the AdminStudio Interface Catalog menu. See Users. 


3. Use the OS Snapshot Wizard to generate snapshots for the desktop(s) used by your company. See 
Taking OS Snapshots. 


4. Use ConflictSolver to create the necessary groups in the database to match how you will distribute these 
packages. See Adding ConflictSolver Groups. 


5. Import all OS Snapshot(s) into ConflictSolver using the bulk import process, and copy these snapshots 
into their appropriate groups. See Command-line Functionality. 


6. If you intend to do conflict detection with ACE12: Merge Modules (meaning that you have 
access/rights to manipulate the MSI package in Tuner or DevStudio to correct any conflicts that are 
found), then pre-import all Merge Modules that are used by your packages, ideally using the bulk 
import process. If you are not performing conflict detection on merge modules, you do not need to 
import merge modules. 


7. Find out how these packages will be distributed and used in your enterprise, and then decide which 
ACEs you need to use during conflict detection. 
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Conflict Detection Processing 


To perform conflict detection processing 


1. Validate your packages. Validation errors may not be serious, but you should be aware of them. 
Because the results of the ConflictSolver Validation Wizard are not persisted in the database, you can 
use another product, like Microsoft Orca, to do your validation, if desired. 


2. Use the bulk import process to import your packages into a temporary working group. 


3. Select your most critical, important application (perhaps for each group), and run validation and the 
source-only ACEs (ACEO4, ACEO5, ACE06) on it. If the package passes evaluation, then move it from 
the working group into its appropriate group. This package will represent the baseline against which all 
subsequent packages will be checked against. 


4. Select your next package and run conflict detection with the ACE rules that you have identified as 
important against the group that this package will be assigned to. Evaluate the results and move the 
package into its appropriate group. Repeat the process. 


5. You should always be evaluating one package against a group of already approved packages for 
conflicts. Any resolutions that you perform will be against the package you are evaluating. 


Post-Conflict Detection Evaluation 


Once you are done performing conflict detection with all of your packages, you should have groups of packages 
which can co-exist with each other. 
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Managing ConflictSolver 


ConflictSolver relies on the AdminStudio Application Catalog to store package information. When you use 
ConflictSolver, you will either automatically be logged into an Application Catalog, or you will have to connect to an 
existing catalog. Once you have connected to a catalog, you can manipulate data in ConflictSolver, including creating 
and organizing groups and providing extended attribute data. 


Connecting to Existing Application Catalogs 


To connect to an existing Application Catalog: 
1. Launch ConflictSolver. 


2. From the Catalog menu, select Connect. The Connect to Application Catalog Dialog opens. 


Connect to Application Catalog 


Existing | Recent 


© Microsoft Access 
= 


O Microsoft SOL Server / MSDE 
= 


If you want to connect to an existing AdminStudio Application 
Catalog, specify it here and click Open. 


3. In the Connect to Application Catalog Dialog's Existing tab, select the type of database you want to 
open for the Application Catalog: Microsoft Access or Microsoft SQL Server / MSDE (Microsoft SQL 
Server 2000 Desktop Engine). Alternatively, select the Recent tab and select a recently-used Application 
Catalog. 


4. If you selected Microsoft Access for the database type, provide the name and location of the 
Access file and click Open. The specified Application Catalog is opened. 
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5. If you selected Microsoft SQL Server / MSDE for the Application Catalog type, perform the 
following steps: 


a. Click Open to display the SQL Server / MSDE Login Dialog. 


SQL Server / MSDE Login 


Server: | TESTLABSQL2K 


How should SQL Server verify the authenticity of the login ID? 
Ov With Windows NT authentication using the network login ID, 


@ With SQL Server authentication using a login ID and password 
entered by the user, 


Login ID; sa 


Password: 


Database: | AS31WorkFlow 


b. In the SQL Server / MSDE Login Dialog, select or specify the Server where the Application Catalog 
is stored. 


c. Specify how SQL Server or MSDE should verify the authenticity of the login—either using Windows 
NT authentication or using SQL Server authentication. If you select SQL Server authentication, 
specify the Login ID and Password to log in. 


d. Browse for the Application Catalog you want to open in the Database field. 


e. Click OK. The specified Application Catalog is opened. 


If you are opening an earlier AdminStudio database (3.0, 3.01, or 3.5), you need to upgrade it to an Application 
Catalog. This changes the database schema and also combines both the Workflow and ConflictSolver databases. You 
can perform the upgrade using the Upgrade Wizard. 
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User Permissions in ConflictSolver 


ConflictSolver User Permissions is a snap-in feature only available with InstallShield AMS 2.0. 


In conjunction with InstallShield AMS 2.0, security and permissions can be assigned to ConflictSolver users, which 


restrict the tasks that can be performed in ConflictSolver. The following table describes the various ConflictSolver 


permissions. 


Permission 


Explanation 


Import Applications 


Can import packages or merge modules into ConflictSolver, including re-importing 
packages resulting from unlinked data or conflict resolution 


Delete All 


Can purge all ConflictSolver data from the Application Catalog 


Delete 


Can delete individual packages from the Application Catalog 


Run Conflicts 


Can use the Conflict Wizard to identify conflicts 


Run Rules Wizard 


Can run the Rules Wizard to import user-defined ACE rules 


Resolve Conflicts 


Can resolve detected conflicts 


Merge Database 


Can merge ConflictSolver information in two Application Catalogs 


Change Data 


Can write to the Application Catalog for ConflictSolver (without this permission, any 
ConflictSolver permission that allows users to write to the Application Catalog will 
not function; ConflictSolver is essentially read-only for roles without this permission) 


Change Extended Attributes 


Can change the XML file used to configure the extended attribute definition 


Change Database 


Can open another Application Catalog 


Additionally, AdminStudio Administrators can restrict access to ConflictSolver completely by disabling the 


ConflictSolver tool permission. 
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ConflictSolver Grouping 


Within ConflictSolver, you can create groups to organize your products and OS Snapshot images. This is especially 
useful for organizing ConflictSolver in ways consistent with how your company is organized. For example, you could 
create a group representing a certain department's base image including the proper operating system and necessary 
applications. When you perform conflict analysis on new packages you are integrating into your environment, you can 
run only the relevant comparisons—saving you the time it would take to run the analysis against all packages in 
ConflictSolver, or the effort of manually determining the set of packages against which you want to run the analysis 
each time. 


Organizing Products in ConflictSolver 


To organize individual packages and groups of packages in ConflictSolver: 
1. From the products explorer, select a product or group you want to move. 


2. Drag the product or group onto a new group. 


The following rules apply to drag and drop operations in the ConflictSolver products explorer: 
1. You cannot drop a node on itself. 


2. You cannot drop a node on its parent. It is already a child of the parent. 
3. You cannot drop a group on its child groups. 
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Adding ConflictSolver Groups 


To add a group to ConflictSolver: 


1. In the products explorer, right-click on the group to which the new group should belong and select New 
Group. 


E (i Groups 
ce RB AceosConflict (v1.00.0000) 
(HS ACETests 


m 
pa 
Q 
[=] 
-g 
oO 


GA] DemoPlayer (v1,00.0000) 
(a InstallShield AdminStudio (v5.01) 
i McAfee VirusScan (v4.5.0) 
>) Nartco_ACEO6 Two (v1.00,0000) 


» 


oF 


Ne oup Ctrl+G 
Rename 
Delete Del 


Ctrl+F 


Ctrl+x 


Cri 


© 
fB 
2 
© 
Q 
D 
z 


g7 nry r ggg 
Se 


Properties Ctrl+P 


2. Provide a name for the new group. 


a- nee 


hew Groucll 


3. Press Enter. 
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Deleting ConflictSolver Groups 


gt 
2 


Bi 


To delete a ConflictSolver group: 


1. Right-click the group you want to delete in the products explorer and select Delete from the context 
menu. 


2. From the resulting message box, confirm the deletion. 


When you delete a group, all subgroups and packages within that group are also removed from the ConflictSolver 


Editing Group Properties 


To edit group properties: 


1. Right-click on the group from the products explorer and select Properties from the context menu. The 
Group Properties Dialog opens. 
Group Properties 


Name: 


Description: 


Comments: 


2. In the Properties dialog, make the appropriate changes. 


3. Click OK. 
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Copying Packages to Multiple ConflictSolver Groups 


To copy an installation package to multiple ConflictSolver groups: 
1. Select the package from the products explorer. 


2. While holding down the Ctrl key, drag the package to the group into which you want it copied. 


O 


You can also right-click on a package and use the copy and paste commands to copy the item. 


Moving Products, OS Snapshots, and Groups 


In addition to copying OS Snapshots or Products to multiple groups, you can also move OS Snapshots, Products, or 
Groups into other groups. 


To move a product, OS Snapshot, or group in ConflictSolver: 
1. Select the product, OS Snapshot, or group you want to move in the products explorer. 


2. Drag the item into a new group. 


You can also rightclick on a product, OS Snapshot, or group and use the cut, copy, and paste commands to move or 
copy the item. 
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Extended Attributes 


Extended attributes are optional attributes for packages, defined by an extended attribute description file (in XML 
format). Because you can manually create the description file, you have the flexibility to include information about 
each package that may be specific to your organization—such as the users or business groups that receive the package. 


Extended attributes can be edited in the Extended Attributes View on a package-by-package basis. 
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Using Extended Attributes 


Assuming you have created an extended attribute description file (or are using the default provided file), you can 
configure ConflictSolver to use it with the current Application Catalog. 


To use extended attributes in ConflictSolver: 
1. With ConflictSolver open, select Options from the Tools menu. 


2. When the Options Dialog appears, click the Extended Attributes tab. 


Options 


General || impot || Validate || Resolution || Conflicts 
Extended Attributes Duplicate Package 

Extended Attribute Description File 

[EA dminS tudio Shared\E4, Default. xml o m) 


Integrate with AMS 


3. Ensure the Show the Extended Attribute nodes option is selected. 


4. Specify or browse to the extended attribute description file (.xml) containing the extended attributes you 
want to use for ConflictSolver. 


5. Click OK. 


The Extended Attributes view is available under each package in ConflictSolver. 
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ConflictSolver uses an XML file to describe the data that appears in the Extended Attributes view. The name and 
location of this XML file can be specified from the Extended Attributes tab in the Options dialog box. 


Description File Properties 


The description file, which is in XML format, contains tags for each extended attribute (up to a limit of 400 
attributes). It supports text or file values. The following list explains each tag available in the description file. 
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Attribute Description 

Uniqueldentifier This value, which ConflictSolver uses to validate that the XML file is for extended attributes, 
must be set to ISASEAAO. 

Name The name of the attribute as it appears in the Extended Attributes view. This cannot exceed 
255 characters. 

Type The extended attribute type. This can be Text, File, or Selection. If no type is specified, then 
ConflictSolver defaults the attribute to text. 

DefaultValue This tag, available only for Text types, provides the default value for the attribute. This 


optional value cannot exceed 512 characters. 


DefaultFileExtension 


This tag, available only for File types, provides the default file extension when you browse 
for the file. Examples of this could be *.txt, *.bmp, *.doc, or *.* (representing all files). 


FileFilter Provide the file types to populate the File type filter in the Browse dialog. These must be in 
pairs, and in the format Longname (*.ext)| *.ext. Before the closing </FileFilter> tag, you 
must have two pipe symbols (| |). 

For example, to include filters for text files, bitmaps, and all files, use the following line: 
<FileFilter>Text Document (*.txt) | *.txt| Bitmap (*.bmp) | *.bmp |All Files 

(*.*) | *.* | | </FileFilter> 

This value cannot exceed 255 characters. 

Caption The caption for the Browse dialog when using File types. This cannot exceed 255 
characters. 

Values Used only for Selection types, this is a semicolon-delimited list of possible values for the 
selection. These will appear in a drop-down list for the extended attribute. The first value is 
used as the default. The total number of characters of all the values and necessary 
semicolons cannot exceed 255 characters. 

HelpText Text that appears below the value field for either Text or Selection attributes. You can use it 


to provide additional information to help users know what to input. This cannot exceed 
512 characters. 
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An example of an extended attribute description file follows: 


<Extended_Attribute UniqueIdentifier="ISASEA40"> 
<AttributeDetai 1s> 
<Name>Owner</Name> 
<Type>Text</Type> 
<DefaultValue></Defaultvalue> 
<HelpText>Provide the name of the package's owner.</HelpText> 
</AttributeDetai Is> 
<AttributeDetai 1s> 
<Name>Test Script</Name> 
<Type>Fi le</Type> 
<DefaultFileExtension>*.*</DefaultFi leExtension> 
<FileFilter>All Files (*.*)|*.*||</FileFilter> 
<Caption>Test Script Files</Caption> 
</AttributeDetai ls> 
<AttributeDetai 1s> 
<Name>Program Type</Name> 
<Type>Selection</Type> 
<Values>Office Application;Utility;Graphic Application;Programming 
Application;Game;Other</Values> 
<HelpText>Select the type of application from the above list.</HelpText> 
</AttributeDetai ls> 
</Extended_Attribute> 
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Extended Attributes and AMS 


ConflictSolver Extended Attributes integration with AMS is a snap-in feature available only with InstallShield AMS 2.0. 


ConflictSolver allows you to integrate extended attributes with InstallShield AMS 2.0. This is accomplished through 
the Extended Attributes Tab of the Options Dialog. 


Options 


General __||__ Import Validate || Resolution ‘| Conflicts 
Extended Attributes Duplicate Package 


Extended Attribute Description File 
c:\AdminStudio Shared\EA Default xmi : 


Integrate with AMS 


When the Integrate with AMS option is selected, you can associate extended attribute data for products in 
ConflictSolver with products in AMS. This is accomplished by right-clicking on the product name in the products 
explorer and selecting Associate with AMS Application from the context menu. 


The Associate with AMS Application dialog is displayed, allowing you to pick the application in AMS with which you 
want to associate the product in ConflictSolver. 


Assuming the Associate with AMS Application option is selected and AMS is configured to use the same extended 
attributes file, if you enter new data into the extended attributes view, AMS automatically detects it; if changes are 
made in AMS, they are automatically reflected in ConflictSolver. By design, extended attributes data in ConflictSolver 
and AMS data have a one-to-one relationship. You can only associate one AMS application with a product in 
ConflictSolver; once the application is associated, it is no longer available for association with other ConflictSolver 
products. 
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For more information on associating extended attribute data for a product with an application already in AMS, see 
Associate with AMS Application Dialog. 


Deleting Packages 


To delete a package from ConflictSolver: 


1. Right-click on the package in the products explorer, point to Delete on the context menu, and select 
Package. 


2. Confirm the deletion. 


You can also delete the package from all groups from the context menu. 


Purging Conflict Information from the Application 
Catalog 


A wh N 


To delete all ConflictSolver data from the Application Catalog: 
1. From the Catalog menu, select Delete All. 


2. Confirm the purge. 
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About the ConflictSolver Application Catalog 
Database 


What is the ConflictSolver Application Catalog Database? 


The ConflictSolver Application Catalog Database is an efficient way to consolidate data from many MSI (Microsoft 
Installer) packages in a single location. The MSI ICEs (internal consistency evaluators) work on specific packages 
while the ConflictSolver ACEs (application conflict evaluators) are designed to extend the ICEs and evaluate data 
across packages. To do this enterprise level data checking, it is very efficient if the data can be consolidated into a 
single database. 


What is Stored in the ConflictSolver Database? 


The ConflictSolver database contains the complete contents of an MSI or MSM (merge module) package and OS 
snapshot. The complete contents can include binary records based upon the import options. 


External Package Conflict Checking 


The ConflictSolver Wizard allows you to run conflict checks against external MSI packages and packages imported 
into the ConflictSolver Application Catalog Database. ConflictSolver supports external package conflict checking for 
Custom - Source Only Packages ACEs. The Source package can be selected from the ConflictSolver Application 
Catalog Database or from an external MSI package. However, ConflictSolver does not support external package 
conflict checking for Custom - Source and Target Packages ACEs. Both the Source and Target Packages must be 
selected from the ConflictSolver Application Catalog Database. 


Microsoft Access Database vs. Microsoft SQL Database 
You can use both Microsoft Access Databases and Microsoft SQL databases with ConflictSolver: 


m Microsoft Access is distributed with Microsoft Office and is thus widely available throughout the world. 
Therefore, Microsoft Access is the most common database used when evaluating AdminStudio. 


m Microsoft SQL Server is a mote robust (and more expensive) database product than Microsoft Access. 


You would choose which database to use based upon familiarity and availability of either database solution. Generally, 
companies choose Microsoft SQL Server over Microsoft Access because the amount of data that they need to 
manipulate is large and SQL Server is considered more practical for this purpose. 
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Searching the Application Catalog 


You can search for data in Application Catalog tables by using Find on the Edit menu. You can search all tables in all 


packages in a Group, or just search one column in one table of one package. The tables that are searched depend 


upon what is selected when the Find Dialog is opened: 


If you select... and specify these options... this will be searched 
Group All Tables and All Columns All tables and all columns in all of the Packages in the 
selected Group 
Package All Tables and All Columns All tables and all columns in the selected Package 
Package A table and All Columns All columns of a specific table in the selected Package 
Package A table and a column A specific column in a specific table in the selected 
Package 
laa’ 
gi \ 
ea 
ear 


To search the Application Catalog: 


1. Select the node in the tree (Group, MSI Package, OS Snapshot, Other Setup, etc.) that you want to 


search. 


2. From the Edit menu, select Find. The Find Dialog opens. 


Find in Package ‘PackageForTheWeb 4 (4.0.0) 


Find What: 


Look In Table: | <All Tables> 


Cancel 


Look In Column: | <All Columns > 


[C] Partial Match 


You could also click the Find P2 uton on the toolbar, use Ctrl + F, or choose Find from the selected 


package or group's context menu. 


3. In the Find What text box, enter the text that you want to search for. 
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4. On the Look In Table list, do one of the following: 


a If a Package was selected when the Find dialog was opened, all of the tables in that Package are 
listed. Select the table that you would like to search, or select All Tables. When you select a table 
from this list, the Look In Columns list is populated with all of the columns in that table. 


= |f a Group is selected when you opened the Find dialog, All Tables is the only option listed. 
5. In the Look In Columns list, do one of the following: 


m |f you selected a table from the Look in Table list, all of the columns in that table are listed. Select 
the column that you would like to search, or select All Columns. 


= |f a Group was selected when you opened the Find dialog, All Columns is the only option listed. 
6. If you want to search for a partial match rather than an exact match, select the Partial Match option. 


m If this option is not selected, ConflictSolver will search for an exact match of the text you 
entered in the Find What text box. The search will be case sensitive. 


a If this option is selected, then ConflictSolver will use appropriate wild card characters so that a 
partial data match is performed. The search will be case insensitive 


7. Click Find to initiate the search. 


The Find dialog will close, and the data that is found is displayed in the Search Results tab of the 
Output window, in the following format: 


17 occurrence(s) of ‘AppSearch’ have been found. 
Package Name Package RowID Table RowID Table Name Column Name Column Data 
csmsiActionText Action AppSearch 


csmsiActionText Action AppSearch 
csmsiActionText Action AppSearch 
csmsisy¥s Validation Table AppSearch 


1414 | > [> Output A Import A validate A, Conflicts A Subscription A, Search Results 


If you double click on the data displayed in the Output Window, ConflictSolver will navigate to the 
appropriate record in the Tables View, and that record will be highlighted in red. 
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About the ConflictSolver Database Schema 


The ConflictSolver Database Schema stores all data used by ConflictSolver. The data is stored in tables based upon 
how it is used. The table prefix identifies the purpose of the table. For example, ConflictSolver System Table names 
begin with cssys. Each table contains one Primary Key and can contain one or many Foreign Keys. 


Table Prefixes 
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The following table lists the prefixes used to name tables in the ConflictSolver Database Schema, and describes the 
purpose of each group of tables: 


Prefix 


Meaning 


assys 


These tables are AdminStudio system tables (such as tables used for security, roles, etc.) 


csmsi 


When ConflictSolver imports a MSI package, ConflictSolver will import all entries from all MSI tables 
within the MSI package. This data will be stored in the ConflictSolver database with the same MSI table 
name prefixed by “csmsi”. The columns within the ConflictSolver table exactly match the columns in the 
original MSI table. However, there are two additional columns added to the ConflictSolver tables: a 
RowlD column for use as a Primary Key, and a PkgRowlD_ column for use as a Foreign Key into the 
cstblPackage table. 


csmsm 


When ConflictSolver imports a Merge Module (MSM file), ConflictSolver will import all entries from all 
Merge Module tables within the MSM file. This data will be stored in the ConflictSolver database with the 
same MSM table name prefixed by “csmsm”. The columns within the ConflictSolver table exactly match 
the columns in the original MSM table. However, there are two additional columns added to the 
ConflictSolver tables: a RowlD column for use as a Primary Key, and a ModuleRowlD_ column for use as 
a Foreign Key into the csmsmModuleSignature table. 


csosc 


These are tables in the ConflictSolver database that contain OS snapshot imported data. These four csosc 
tables—csoscFile, csosclniFile, csoscRegistry and csoscShortcuts—are equivalent to the MSI tables of the 
same name, and contain data that is a conceptual representation of the four types of data in an operating 
system. 


The columns within the ConflictSolver tables exactly match the columns in the original MSI tables. 
However, there are two additional columns added to the ConflictSolver tables: a RowlD column for use as 
a Primary Key, and a PkgRowlD_ column for use as a Foreign Key into the cstblPackage table. 


cssys 


These are ConflictSolver system tables (tables used to store schema information, extended attributes 
schema information, etc.). For a detailed list of ConflictSolver system tables, see cssys: ConflictSolver 
System Tables. 


cstbl 


These are ConflictSolver supporting tables (tables used to store package, groups, conflict persistence, 
etc.). For a detailed list of ConflictSolver supporting tables, see cstbl: ConflictSolver Supporting Tables. 


wftbl 


These are AdminStudio workflow tables (tables used to store workflow, steps, projects, tools, etc.) 


ams_ 


InstallShield AMS 2.0 stores the data in tables whose names begin with ams_. 
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Prefix Meaning 


cssp_ These are the tables that contain the stored procedures used to access data from ConflictSolver tables. The 
ASDataService Web service uses these stored procedures. 


wfsp_ These are the tables that contain the stored procedures used to access data from Workflow tables. The 
ASDataService Web service uses these stored procedures. 


amssp_ These are the tables that contain the stored procedures used to access data from AMS tables. The 
AMSDataService Web service uses these stored procedures. 


Terminology 
The following terms are used in this section to describe table columns: 
Primary Key 


A Primary Key is a column whose values uniquely identify each row in a table. A table can have only one Primary 
Key, and this column must contain a value. In the ConflictSolver Database Schema, the Primary Key is always the 
RowID column. 


Foreign Key 


A Foreign Key is a column or combination of columns used to establish and enforce a link between two tables. In the 
ConflictSolver database, the PkgRowID_ column is the Foreign Key for MSI packages into the cstblPackage table— 
the table that is the primary table containing product information. 
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essys: ConflictSolver System Tables 
The following System tables are included in the ConflictSolver Database Schema: 


m cssysExtendedAttributeSchema 
m cssysSchemaInfo 
m cssysTables 


essysExtendedAttributeSchema 


Extended attributes are optional attributes for packages, defined by an extended attribute description file (in XML 
format). Because you can manually create the description file, you have the flexibility to include information about 
each package that may be specific to your organization—such as the users or business groups that receive the package. 
The cssysExtendedAttributeSchema table contains data about the ConflictSolver Database Schema's extended 
attributes. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
Type int N 
Name text N 
DefaultValue text N 
FileFilter text N 
DefaultFileExtension text N 
Caption text N 
HelpText text N 


This table is comprised of the following columns: 


= RowID—The Primary Key—used to uniquely identify a record. 


= Type—lIndicates the data type of the extended attribute: 0 = Text, 1 = attached File, and 2 = value is specified by 
making a Selection from a list. 


E Name—The name of the extended attribute. The name can be up to 255 characters long. 


E DefaultValue—If the attribute type is Text, this column contains the default text value. If the attribute type is 
Selection, this column contains the list of possible selections. The value of this column can be up to 512 characters 
long. 


m FileFilter—This column contains the standard file filter used for file types. The value can be up to 255 characters 
long. 


E DefaultFileExtension—This column contains the standard file extension used to identify file types. The 
extension can be up to 255 characters long. 
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= Caption—lIf the attribute type is File, the Caption is used for file types on the File Browse dialog. The Caption 
can be up to 255 characters long. 


= HelpText—General help text displayed for Selection and Text types when changing the value of an extended 
attribute. Help text can be up to 512 characters long. 


This table is populated when the user changes the entries on the Tools | Options | Extended Attributes tab. 


essysSchemalnfo 


The cssysSchemalInfo table contains data about the current ConflictSolver Database Schema. This table contains the 
following columns: 


Column Type Key Nullable 
SchemaVersion text N 
UniquelD int N 
LastUser text Y 
LastUsed datetime Y 
ExtendedAttributesFile text Y 
ExtendedAttributesData binary Y 


This table is comprised of the following columns: 


E SchemaVersion—Readable text description of the schema version. This description can be up to 20 characters 
long. 


E UniquelD—Numetic identifier of the database version. 
m LastUser—Not currently used. 
E LastUsed—Not currently used. 


E ExtendedAttributesFile—The file path to the Extended Attributes file that is selected on the Extended 
Attributes tab of the Tools | Options dialog. The file path can be up to 255 characters long. 


E ExtendedAttributesData—The actual Extended Attributes file. 
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essysTables 

The cssysTables table contains data about all ConflictSolver tables. This table contains the following columns: 
Column Type Key Nullable 
RowlD int Y N 
TableName text N 
DateCreated datetime N 
TableType int N 
MappedMsiTable text N 
Status int N 
BaseSchemaVersion text N 
SchemaVersion text N 
DeleteMode int N 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 

TableName—The name of the ConflictSolver table. This name can be up to 72 characters long. 
DateCreated—Date the table was created. 

TableType—Usced internally. 


MappedMsiTable—Name of the MSI table that is equivalent to this table. This table name can be up to 72 
characters long. 


Status—Not currently used. 


BaseSchemaVersion— The version of the database schema that is associated with this table. The database 
schema version can be up to 20 characters long. 


SchemaVersion—WNot currently used. 


DeleteMode— Used internally. 
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cstbl: ConflictSolver Supporting Tables 
The following supporting tables are included in the ConflictSolver Database Schema: 
Database Subscription Tables 


esthISubscribedDatabases 


This table contains database connection information about currently subscribed databases. Each row of this table 
contains database connection information for one subscribed database. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
ServerName text N 
DatabaseName text N 
FriendlyName text N 
AuthMode int N 
Flags int N 
DatabaseType int N 


This table is comprised of the following columns: 


= RowID—The Primary Key—used to uniquely identify a record. 


E ServerName—Name of the server where the subscribed database is located. This name can be up to 255 
characters long. 


= DatabaseName—Name of the subscribed database. This name can be up to 255 characters long. 


E FriendlyName—A more readable form of the database connection information. It is displayed in the user 
interface. This name can be up to 255 characters long. 


= AuthMode—Used internally. 
m Flags—Used internally. 


= DatabaseType—Used internally. 
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esthISubscribedData 


This table contains the data that associates the packages in the subscribed and local databases. This table contains the 
following columns: 


Column Type Key Nullable 
RowlD int Y N 
SubscribedDatabaseRowlD___ int N 
Flags int N 
LocalRowID_ int N 
SubscribedRowID_ int N 


This table is comprised of the following columns: 


= RowlID—The Primary Key—used to uniquely identify a record. 
E SubscribedDatabaseRowID_—Private Key identifier into a subscribed database entry. 
m Flags—lIdentifies the type of subscribed data. 


m LocalRowID_—Forcign Key identifier into the local database's cstblPackage table. This value identifies the 
imported package within the local database. 


m SubscribedRowID_—Forcign Key identifier into the subscribed database's cstblPackage table. This value 
identifies the Source package within the subscribed database. 
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Conflict Persistence Tables 


esthiConflictConfiguration 
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This table contains principal information about a run of the Conflict Wizard. This table contains the following 


columns: 
Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
ProductName text N 
ProductVersion text N 
PackagePath text Y 
ConflictRunDate datetime N 
NoOfErrors int N 
NoOfWarnings int N 
NoOfPkgsChecked int N 
NoResolved int N 
SaveToMST int N 
MSTPath text Y 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 


PkgRowlD_— Foreign Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


ProductName—Name of package that was tested. Name can be up to 255 characters long. 


ProductVersion—Name of package version that was tested. Version can be up to 100 characters long. 


PackagePath—\/hen performing an external package check, this column will contain the package path. Path 
can be up to 512 characters long. 


ConflictRunDate—Date the run of the Conflict Wizard was performed. 


NoOfErrors—Number of automatically-resolvable errors that were identified in this run of the Conflict Wizard. 


NoOfWarnings— Number of warnings (i.e., not automatically resolvable) identified in this run of the Conflict 


Wizard. 
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NoOfPkgsChecked—Number of packages that were checked in this run of the Conflict Wizard. 
NoResolved—Number of errors that were resolved since the last run of the Conflict Wizard over this package. 


SaveToMST—PFlag to indicate whether you want to save the conflict resolutions in a transform (.MST) file or in 
the original package. 


MSTPath— Path to the .MST file that will be used to save conflict resolutions. 


Each package has only the most recent set of conflict detection results persisted. In other words, each time the 
Conflict Wizard is run, the current conflict persistence data for this package is replaced by the new results. 


esthlConflictACE 


This table contains a list of ACEs that were used during the last run of the Conflict Wizard for this package. This 
table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
Name text N 
Category text Y 
Description text Y 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 


PkgRowID_—Forcign Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


Name—Name of the ACE that was run. Name can be up to 72 characters long. 
Category—The category name of the ACE that was run. Category can be up to 72 characters long. 


Description— Description of the ACE that was run. Description can be up to 512 characters long. 


This information is duplicated from the ACE file to use for display purposes in ConflictSolver and for the Run Again 
function in the Conflict View. 


InstallShield Software Corporation © 2004 690 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


esthIConflictPackages 


This table contains a list of packages that were used in the last run of the Conflict Wizard for this package. This table 
contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
LocalPkgRowID_ int N 
ProductName text N 
Comments text Y 
Flags int N 


This table is comprised of the following columns: 


= RowID—The Primary Key—used to uniquely identify a record. 


= PkgRowID_—Porcien Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


E LocalPkgRowID_—Foreign Key identifier into the Target package that was tested in the last run of the Conflict 
Wizard. 


= ProductName—Name of the package that was tested in the last run of the Conflict Wizard. Name can be up to 
255 characters long. 


E Comments—Comments describing the package that was tested in the last run of the Conflict Wizard. Comments 
can be up to 4000 characters long. 


mE Flags—Used internally. 


This information is duplicated from the ACE file to use for display purposes in ConflictSolver and for the Run Again 
function in the Conflict View. 
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esthiConflictResulits 


For each identified conflict, an entry is made in this table. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
SourceRowID_ int N 
UpdateValue text N 
CARDQuery text N 
ACERule text N 
CARDRule text Y 
DisplayString text N 
ResolveString text N 
TableName text Y 
Category int N 
State int N 
TargetProductName text N 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 


PkgRowID_—Forcign Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


SourceRowID_— Foreign Key identifier into the Source record that was identified as causing the conflict. 


UpdateValue—For conflicts that have an automatic resolution, this column will contain data specific for that 
resolution. For non-resolvable ACEs, this field is blank. Value can be up to 1024 characters long. 


CARDQuery—For conflicts that have an automatic resolution, this column will contain data specific for that 
resolution. For non-resolvable ACEs, this field is blank. Query can be up to 1024 characters long. 


ACERule—The name of the ACE Rule that was run to identify this conflict. Rule can be up to 72 characters long. 


CARDRule—The name of the CARD Rule, if any, that can fix this conflict. If there is no CARD associated with 
the ACE, this column is blank. Rule can be up to 72 characters long. 


DisplayString—Text displayed in the Conflict View prior to ACE resolution. String can be up to 2048 
characters long. 
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ResolveString— Text displayed in the Conflict View after ACE resolution. String can be up to 2048 characters 
long. 


TableName—Name of table associated with the ACE that contains the conflicting data. Name can be up to 255 
characters long. 


Category—Category of the ACE. It matches an entry in the ACE file. 
State—Identifies the status of the ACE: Resolved or Unresolved. 


TargetProductName—Name of the Target Package that resulted in this conflict being identified in this run of 
the Conflict Wizard. Name can be up to 255 characters long. 


esthlConflictTransformList 


When performing an external package check, this table contains a list of the external package's associated transforms. 
This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlID_ int N 
TransformPath text N 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 


PkgRowlD_— Foreign Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


TransformPath— Path of the transform file used in this external package check. Path can be up to 512 characters 
long. 


This table is relevant only for external package checks. 


esthIConflictResultsDestPkgs 


This table contains Target package conflict information. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlID_ int N 
ConflictResultsRowID_ int N 
DestRowlID_ int N 
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This table is comprised of the following columns: 


= RowlID—The Primary Key—used to uniquely identify a record. 


E PkgRowID_—Forcign Key identifier into the cstblPackage table to which these conflict persistence results are 
associated. If the value is -1, it indicates that the data is associated with an external package. 


E ConflictResultsRowID_—Forcign Key to the Conflict Results table entry. 


E DestRowID_—Foreign Key identifier into the Target record that was identified as causing the conflict. 


Package and Transform File Tables 


esthIPackage 


The cstblPackage table is the core ConflictSolver table that contains information about imported packages. This table 
contains a unique Package ID (the RowID column) that is referenced by all other data tables. This table contains the 
following columns: 


Column Type Key Nullable 
RowlD int Y N 
PackageCode text N 
ProductCode text N 
ProductVersion text N 
UpgradeCode text N 
ProductName text N 
Manufacturer text N 
ProductLanguage int N 
FileName text N 
Comments text N 
ImportDate datetime N 
FileModifiedDate datetime N 
Flags int N 
DisplayedProductName text N 
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This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 

PackageCode—The value of the equivalent MSI PackageCode. Code can be up to 100 characters long. 
ProductCode—The value of the equivalent MSI ProductCode. Code can be up to 100 characters long. 
ProductVersion—The value of the equivalent MSI ProductVersion. Version can be up to 100 characters long. 
UpgradeCode—The value of the equivalent MSI UpgradeCode. Code can be up to 100 characters long. 
ProductName—The value of the equivalent MSI ProductName. Name can be up to 255 characters long. 
Manufacturer—The value of the equivalent MSI Manufacturer. Name can be up to 255 characters long. 
ProductLanguage—The value of the equivalent MSI ProductLanguage. 

FileName—UNC path to the MSI package. Name can be up to 255 characters long. 

Comments— User description of the package. Comments can be up to 4000 characters long. 
ImportDate—Date package was imported. 

FileModifiedDate—Detived from the file system, this is the date that the package (MSI) file was last modified. 
Fleags—Used internally. 


DisplayedProductName—Name of package that is displayed in the ConflictSolver Product View. Name can be 
up to 255 characters long. 


esthITransformFile 


Contains a list of transforms associated with a package. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
TransformFile text N 
ProductLanguage text N 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 
PkgRowlD_— Foreign Key identifier into the package associated with this transform file. 
TransformFile—Name of transform file. File can be up to 255 characters long. 


ProductLanguage—Name of language of product in string form. Language can be up to 128 characters long. 


This table is used only if the imported package includes transforms. 
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Groups Tables 


csthIGroups 


ConflictSolver allows categorizing related packages using Groups. The cstblGroups table is used to store the 
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information about ConflictSolver groups. ConflictSolver ships with one row in this table that defines the root node in 
the Groups tree. A group may contain imported packages or other sub-groups; these parent-child relationship details 
are stored in the cstblGroupPackages table. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
GroupName text N 
Description text N 
Comments text N 
Properties int N 
CreatedDate datetime N 
ModifiedDate datetime N 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 
GroupName—Name of group. Name can be up to 72 characters long. 


Description—Description of group. Description can be up to 128 characters long. 


Comments—Comments associated with group. Comments can be up to 255 characters long. 


Properties— Used internally. 
CreatedDate—Date group was created. 


ModifiedDate—Date group was last modified. 
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Miscellaneous Tables 


esthIPackageRelationships 


Table that stores the relationship between packages which were considered duplicate packages at the time of 


importation. This table contains the folowing columns: 
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Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
SecondPkgRowID_ int N 
Relationship int N 


This table is comprised of the following columns: 


= RowlID—The Primary Key—used to uniquely identify a record. 


E PkgRowld_— Foreign Key identifier into the first package associated with this duplicate relationship. 


E SecondPkgRowID_—Forcien Key identifier into the second package associated with this duplicate relationship. 


= Relationship— Used internally. 


esthlignoreTableList 


This table contains a list of tables to exclude during the import process. This table contains the following columns: 


Column Type Key Nullable 
RowlID int Y 

TableName text 

Comments text 


This table is comprised of the following columns: 


= RowID—The Primary Key—used to uniquely identify a record. 


E TableName—Name of ignored table. Name can be up to 255 characters long. 


= Comments—Any user comments. Comments can be up to 4000 characters long. 
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esthIPackageHistoryLog 


This table contains a log of changes made to a package. This table contains the following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlD_ int N 
LogText text Y 
ShortDesc text Y 
LogData image Y 
Type int N 
CreateDate datetime N 
UserID text Y 


This table is comprised of the following columns: 


= RowlID—The Primary Key—used to uniquely identify a record. 

E PkgRowID_—Forcign Key identifier into the package associated with this history log. 

= LogText—Information specific for this type of log entry. 

= ShortDese—Short description of this type of log entry. Description can be up to 255 characters long. 
= LogData—Not currently used. 

= Type—lIndicates what type of log entry this represents. 

= CreateDate—Date the history log was created. 


E UserID—Not used. 


Currently only used to store information about the import configuration options. 
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Extended Attributes Tables 


csthlExtendedAttributeData 


This table contains the actual Extended Attribute data that is associated with a package. This table contains the 
following columns: 


Column Type Key Nullable 
RowlD int Y N 
PkgRowlID_ int N 
Name_ text N 
DataField text Y 
DataBLOBField binary Y 


This table is comprised of the following columns: 


RowID—The Primary Key—used to uniquely identify a record. 
PkgRowlD_— Foreign Key identifier into the package associated with this extended attribute data. 
Name_—Private Key into the extended attribute schema table. Name can be up to 255 characters long. 


DataField—If extended attributes are of File type, this column contains the path to the file. If extended 
attributes are in Text or Selection type, this column contains the actual data value of the extended attributes. Data 
can be up to 255 characters long. 


DataBLOBField—If the extended attribute is of File type, this column contains the contents of that file. 


Only if the user has entered extended attribute data for a package (an extended attribute element), would there be an 
entry in this table. 
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Group Packages Tables 


esthIGroupPackages 
This table defines the relationship between packages and groups. This table contains the following columns: 
Column Type Key Nullable 
RowlD int Y N 
ParentGroupCode int N 
PkgRowlD_ int N 
MemberGroupCode int N 


This table is comprised of the following columns: 


= RowlID—The Primary Key—used to uniquely identify a record. 


= ParentGroupCode—Forcign Key identifier into the cstblGroup table. Parent group containing either the 
package or the group entry (Group Row ID). 


= PkgRowID_—Forcign Key identifier into the cstblPackage table. If this is a group, the value in this column is 0. 
Otherwise, it contains the PackageRowID. 


= MemberGroupCode—PForcien Key identifier into the cstblGroup table. If this is a package, the value in this 
column is -1. Otherwise, it contains the GroupRowID. 
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Importing Data 


MEN 

@ iz 
Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


You use the Import Wizard to import Windows Installer packages (.msi) with any associated transforms (.mst) or 
patches (.msp) and merge modules (.msm) into the Application Catalog. Additionally, you can use the Import Wizard 
to import OS snapshots (.osc), Marimba Native Channel Packager (.ncp) files and other non-MSI based setup 
programs. For a description of these installation package types, see Supported Import Types. 


Tasks associated with Import include: 


Importing Windows Installer Packages With Associated Transform and Patch Files 
Importing OS Snapshots 

Importing Merge Modules 

Importing Marimba NCP Files 

Importing Other Setup Types 

Specifying Duplicate Package Identifiers 


Once you import these files, they become available for conflict identification. Although you can identify conflicts 
between an external package and packages already in ConflictSolver, it is strongly recommended you import the 
package first and perform conflict identification after import. Conflict information is only persisted for the last 
conflict identification performed between an external package and packages in ConflictSolver, and performance is 
better when performing conflict identification between internal packages. 


Supported Import Types 


@— 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


ConflictSolver supports the import of the following installation package types: 


Windows Installer (.msi) 
Transforms (.mst) 
Patches (.msp) 

Merge Modules (.msm) 
OS Snapshots (.osc) 
Marimba NCP (.ncp) 
Other Setup Types 
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Windows Installer (.msi) 


ConflictSolver supports the import of Windows Installer packages (.msi). A Windows Installer package contains all of 
the information that the Windows Installer requires to install or uninstall an application or product and to run the 
setup user interface. The .msi file can also contain one or more transforms and/or patches. 


A Windows Installer package is organized around the concepts of components and features: 


m A feature is a part of the application's total functionality that a user may decide to install independently. 


= A component is a piece of the application or product to be installed. 


The Windows Installer always installs or removes a component from a uset's computer as a coherent piece. 
Components are usually hidden from the user. When a user selects a feature for installation, the installer determines 
which components must be installed to provide that feature. 


Transforms (.mst) 


ConflictSolver supports the import of Windows Installer packages (.msi) with associated transforms (.mst). A 
transform is a collection of changes applied to an installation. By applying a transform to a base installation package, 
the installer can add or replace data in the installation database. The installer can only apply transforms during an 
installation. 


The installer registers a list of transforms required by the product during the installation. The installer must apply 
these transforms to the product's installation package when configuring or installing the product. 


A transform can modify information that is in any persistent table in the installer database. A transform can also add 
or remove persistent tables in the installer database. Transforms cannot modify any part of an installation package that 
is not in a database table, such as information in the summary information stream, information in substorages, 
information in nested installations, or files in embedded cabinets. 


Patches (.msp) 


ConflictSolver supports the import of Windows Installer packages (.msi) with associated patches (.msp). A Patch 
package is used by Windows Installer to patch local or administrative installations. A patch package is a storage file, 
similar to a descriptor file. A patch package does not include a database like a regular installation package. Instead it 
contains at minimum one database transform that adds patching information to the database of its target installation 
package. 


Merge Modules (.msm) 


ConflictSolver supports the import of merge modules (.msm). Merge modules are essentially simplified Windows 
Installer (.msi) files. 


A metge module cannot be installed alone because its lacks some vital database tables that are present in an 
installation database. Merge modules also contain additional tables that are unique to themselves. To install the 
information delivered by a merge module with an application, the module must first be merged into the application's 
msi file. 
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Marimba NCP (.ncp) 


@o- 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


Marimba NCP (Native Channel Packager) files are used to describe software components, their versions, their 
underlying structures, and their dependence on other components. Marimba's NCP file is derived from an OSD 
(Open Software Description) file and is currently used by Marimba's Castanet family of products. 


Clients, such as Marimba Castanet Tuners, can use an NCP file to learn what files constitute a software package for 
particular software for a particular client platform and particular user preferences. Just as an HTML file can contain 
links to other HTML or media files, so can an OSD file contain links to other NCP files. These linked NCP files 
represent sub-packages or dependencies. 


The following is an example of a very simple NCP file: 


<SOFTPKG NAME=com.Instal1lshield.www.AdminStudio" VERSION="1,0,0,0"> 
<TITLE>Solitaire></TITLE> 
<ABSTRACT>AdminStudio by InstallShield Corporation</ABSTRACT> 
<LICENSE HREF=http://www. installshield. com/AdminStudio/license.html /> 

<IMPLEMENTATION< 

<OS VALUE-"WinNT"><OSVERSION VALUE-"4,0,0,0"/></OS> 

<OS VALUE-"Win95"> 

<PROCESSOR VALUE="x86"/> 

<LANGUAGE VALUE="en"/> 

<CODEBASE HREF=http://www. installshield. com/AdminStudio.cab/> 

</IMPLEMENTATLION> 

</SOFTPKG> 


ConflictSolver supports the import of Marimba NCP Version 4.7.2 files into the AdminStudio Application Catalog, 
making them available for conflict identification and resolution. Please note the following: 


m The Marimba NCP file that should be imported into ConflictSolver is always named manifest.ncp. If you attempt 
to import another file with an .NCP extension into ConflictSolver, the import will fail. 


Em Information from NCP files is stored in OS Snapshot specific tables within the Application Catalog. 


m An NCP file can be selected as a source and a target package for Conflict detection, using ACE23 and ACE24. 
However, reporting, validation, and conflict resolution are not supported for the NCP package type. 


m Extended Attributes are supported for NCP packages. 


Em You can import NCP files from the command line. 
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OS Snapshots (.osc) 


ConflictSolver supports the import of OS Snapshot (.osc) files, which are files representing a particular computer 
system's contents. To generate an OS snapshot file, use the OS Snapshot Wizard to scan a computer's operating 
system and record the files, INI files, shortcuts, and registry entries present. The Wizard saves this information in an 
.osc file. When an OS Snapshot file is imported into ConflictSolver, it can be used as a reference point for conflict 
identification. See Taking OS Snapshots for more information. 


To provide maximum flexibility during the OS Snapshot process, you can use the Global Exclusion Editor to create 
an exclusion list that identifies files, INI files, shortcuts, and registry entries that the OS Snapshot Wizard should 
disregard during the scan. Using this list, you can eliminate unnecessary files, shortcuts, or registry entries, and reduce 
the time it takes to perform the OS Snapshot. See Configuring Exclusions for more information. 


OS Snapshots should only be used for comparison in ConflictSolver. You should never attempt to convert an OS 
Snapshot into an MSI package. 


Other Setup Types 


A wide variety of other (i.e., non-MSJ) setup formats exist. ConflictSolver supports the import of non-MSI setup 
types (such as InstallShield Professional or ISMP installations) into the Application Catalog. By importing these other 
setup formats, you allow AdminStudio to manage these setups in a manner consistent with other MSI based packages. 


To import a setup type into the Application Catalog that is not listed on the Import Data Types Panel of the Import 
Wizard, choose Other Setup Types. When importing one of these setup formats, you specify a directory or a directory 
hierarchy, and ConflictSolver will scan any setup.exe or isetup.exe files for pertinent setup information. 


Remote Package Alert, Application Catalog Replication, reporting, validation, conflict detection, and thus conflict 
persistence are not supported by the Other Setup Types package type. However, the Merge process does support this 


package type. 
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Importing Windows Installer Packages With 
Associated Transform and Patch Files 


ConflictSolver stores imported Windows Installer installations for further conflict analysis. When you import a 
package into ConflictSolver, you can automatically run validation and conflict identification features, if configured 
through the Options Dialog box. 


To import a Windows Installer package with any associated Transform and Patch files 
into ConflictSolver: 


1. Select Import File from the Catalog menu. The Import Wizard Welcome Panel opens. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages (MSI), transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import your 
OS snapshots (OSC), Marimba Native Channel packager 
(NCP) and other non-MSI based setup programs. 


Click 'Next' to continue. 
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2. On the Import Wizard Welcome Panel, click Next. The Import Data Types Panel opens. 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press 'Next' to continue. 


Import Data Types 


MSI Package and Associated Transform Files 


Description 


An MSI package contains all the information Windows Installer needs to install or uninstall an 
application. A transform file is used to customize the installation. 


| 
3. From the Import Data Types Panel, select: 


= MSI Package and Associated Transform Files—Select to import an MSI package or an MSI 
package with Transform files. 


= MSI Package and Associated Transform and Patch Files—Select to import an MSI 
package with Patch files or an MSI package with Transform and Patch files. 
4. Click Next. The MSI Source Information Panel opens. 


Import Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Select one MSI package file (MSI) in order to proceed with the import process. You may 
optionally select one or more transform files (MST) to be associated with the package file. 


Select an MSI file: 
C:\AdminStudio Shared\Orca.ms} 


| Browse... 


[Transforms Lmst): 


C:\AdminStudio Shared\Orcal mst 
C:\AdminStudio Shared\Orca2. mst 


(cise Jone) (Coane) (eee) 


5. From the MSI Source Information Panel, click Browse to locate the MSI file you want to import. 
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6. Should the package require transforms, click the New | button above the Transforms area to insert a 
new Transform file entry line, and then use the Browse button (...) to locate the transform. If the package 
requires multiple transforms, you can repeat the procedure as necessary. The order in which transforms 


are applied can be changed by selecting a transform and clicking 4| (Move Up) and +| (Move 
Down). If you need to delete a transform you have added, select the transform and click x| (Delete). 


7. If necessary, click Advanced Options to access the Advanced Options Dialog where you can set 
advanced import options for handling custom tables. 


8. Click Next. 


m |f you selected MSI Package and Associated Transform Files, the Destination Group Panel 
appears. Skip to Step 10. 


m |f you selected MSI Package and Associated Transform and Patch Files, the Patch Source 
Information Panel appears. continue with Step 9. 


Import Wizard 


Patch Source Information 
Specify one or more Patch file(s}. 


Select one or more Patch files (MSP or EXE) to store in the Application Catalog and click 'Next’ 
to continue. 


-Patches [.msp or .exe): 


[ C:\AdminStudio Shared\Orca.msp 


e ConflictSolver will perform an administrative install of the MSI package and the patch 
1 files. Then, the MSI package at the installed location, which now contains the patch 
file(s] contents, will be imported into the Application Catalog. 


Specify the location for Administrative install: 


| C:\AdminStudio Shared\ConflictSolver\Orca | 


9. On the Patch Source Information Panel, perform the following steps: 


a. Specify the patch packages (.msp or update.exe) you want to import into ConflictSolver. To do this, 
on : ; . 

use the New Ż=+Ibutton in the Patches area to insert a new Patch file entry line, and then use the 

Browse button (...) to locate the patch. If the package requires multiple patches, you can repeat the 


procedure as necessary. The order in which patches are applied can be changed by selecting a 
patch and clicking $| (Move Up) and +| (Move Down). If you need to delete a patch you have 
added, select the patch and click x| (Delete). 


If you specify an update.exe patch file that was created by Developer/DevStudio, ConflictSolver will extract 
the .msp file in the Temp folder and then perform the import. 
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b. Use the Browse button to enter a directory in the Specify the location for Administrative install text 
box. 


For patches to be applied to an MSI package, it is necessary to perform an Administrative install of the MSI 
package and then perform an Administrative install of each patch package one by one. This way, the content 
of each patch package is appended to the MSI package at the Administrative install location. 


c. Click Next. The Destination Group Panel appears. 


Import Wizard 


Destination Group 
Specify the destination group for your installer package. 


Select one or more destination groups into which your package will be imported. 


= CG Groups 
CIG Accounting 
OG Marketing 
ae 


(seek ETE [cava] (ie) 


10. From the Destination Group Panel, specify the group(s) into which you want to import the package. 
Click Next. The Summary Panel opens. 


Import Wizard 


Summary 
Review your options. 


MSI file to import: 
Orca.msi 


Transform{s): 
Orcal.mst 
Orca2.mst 


Destination group{s) for the package: 
Research 


Options: 
Validate the package before importing? Yes 
Check for conflicts before importing? No 
Import custom tables? Yes 
Import binary data? Yes 
43 ii > 


Click Finish to accept these options. 
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11. Review the information in the Summary Panel. If you are satisfied with the import options, click Finish to 
start the import. 


A report of the import process appears on the Import tab in the Output window. Depending on whether options 
have been set from the General tab of the Options Dialog (available from the Tools menu), validation and conflict 
checking may be performed during import. 


The Windows Installer package appears in the products explorer under the selected group. 


You can also import a Windows Installer package by right-clicking the group into which you want to import the 
package and selecting Import | Msi Package or Msi Package with Patches. The MSI Source Information panel is 
displayed in the Import Wizard, and you can proceed with the steps above. However, since you have already 
specified the group into which you want to import the package, the Destination Group Panel does not appear. 


w 


Although not required, InstallShield recommends you import only Windows Installer packages that have passed the Full 
MSI Validation Suite validation into ConflictSolver. 
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Importing OS Snapshots 


The ConflictSolver stores imported OS Snapshots for further conflict analysis. 


— 
To import an OS Snapshot into ConflictSolver: 


1. Select Import File from the Catalog menu. The Import Wizard Welcome Panel opens. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages (MSI), transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import your 
OS snapshots (OSC), Marimba Native Channel packager 
(NCP] and other non-MSI based setup programs. 


Click ‘Next’ to continue. 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press ‘Next’ to continue. 


Import Data Types 


| OS Snapshot File 


Description 


ån OS Snapshot file, generated by the Snapshot Wizard, lists all the files, INI files, shortcuts, 
and registry entries present on a computer's operating system. 


ETE ETE (cove) (te) 
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3. From the Import Data Types Panel, select OS Snapshot File. 


4. Click Next. The OS Snapshot Information Panel opens. 


Import Wizard 


OS Snapshot Information 
Specify the OS Snapshot file. 


Select an OS snapshot (OSC) file and click Next to continue. 


OS Snapshot: 
C:\AdminStudio Shared\OS Snapshots\Windows2000.osc 


5. From the OS Snapshot Information Panel, click Browse to locate the OS Snapshot you want to import. 


6. Click Next. The Destination Group Panel appears. 


Import Wizard 


Destination Group 
Specify the destination group for your installer package. 


Select one or more destination groups into which your package will be imported. 


3 OG Groups 
CG Accounting 
CG Marketing 
ae 


eS Ce E r) 
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7. From the Destination Group Panel, specify the group(s) into which you want to import the package. 
Click Next. The Summary Panel opens. 


Import Wizard 


Summary 
Review your options. 


Snapshot File: 
Windows2000. osc 


Windows Version: Windows 2000 - 5.0.2195 
Snapshot Version: 3.50 


System Language: English (United States] 
User Language: English (United States] 


t2 


Click Finish to accept these options. 


8. Review the information in the Summary Panel. If you are satisfied with the import options, click Finish to 
start the import. 


OS snapshots are always put in the root group in ConflictSolver. A report of the import process appears on the 
Import tab in the Output window. 
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importing Merge Modules 


For optimal performance, merge modules (.msm) should be imported into the ConflictSolver Database prior to 
importing Windows Installer packages. This ensures that conflicts resulting from not using available merge modules 
are correctly identified. 


To import a merge module into ConflictSolver: 


1. Select Import File from the Catalog menu. The Import Wizard Welcome Panel opens. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages [MSI], transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import your 
OS snapshots (OSC), Marimba Native Channel packager 
[NCP] and other non-MSI based setup programs. 


Click 'Next' to continue. 


mre mre 
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2. On the Import Wizard Welcome Panel, click Next. The Import Data Types Panel opens. 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press 'Next' to continue. 


Import Data Types 


Merge Module Files 


Description 


An MSM file is a single package that includes all files, resources, registry entries, and setup 
logic to install a shared component. 


(cise Jue) CO crea J (Hoe) 


3. From the Import Data Types Panel, select Merge Module Files. 


4. Click Next. The MSM Source Information Panel opens. 


Import Wizard 


MSM Source Information 
Specify the MSM file. 


Select one or more merge modules (MSM) files to store in the Application Catalog and click 
‘Next! to continue. 

Merge Modules (.msm): 
| C:\AdminStudio Shared\pfiles.msm 

C:\AdminStudio Shared\pfileen.msm 


(...) to locate the merge module. 


To add multiple merge modules, you can repeat the procedure as necessary. The order of the merge 
modules can be changed by selecting a merge module and clicking | (Move Up) and +| (Move 


Down). If you need to delete a merge module you have added, select the merge module and click x| 
(Delete). 
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6. Click Next. The Summary Panel opens. 


Import Wizard 


Summary 
Review your options. 


Merge Module file(s) to import: 
pfiles.msm 
pfileen.msm 


2) 


Click Finish to accept these options. 


7. Review the information in the Summary Panel. If you are satisfied with the import options, click Finish to 
start the import. 


A report of the import process appears on the Import tab of the Output window. The merge module appears under 
the Merge Modules tab in ConflictSolver. 
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Importing Marimba NCP Files 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


To import a Marimba NCP (.ncp) file into ConflictSolver, select the Marimba NCP File option on the Import Data 
Types Panel of the Import Wizard. 


To import a Marimba NCP File into ConflictSolver: 


1. Select Import File from the Catalog menu. The Import Wizard Welcome Panel opens. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages [MSI], transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import your 
OS snapshots (OSC), Marimba Native Channel packager 
[NCP] and other non-MSI based setup programs. 


Click 'Next' to continue. 


Cancel 
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2. On the Import Wizard Welcome Panel, click Next. The Import Data Types Panel opens. 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press 'Next' to continue. 


Import Data Types 
Marimba NCP File 


Description 


NCP files are used to describe software components, their versions, their underlying 
structures, and their dependence on other components. 


| 
3. Select Marimba NCP File and click Next. The Marimba NCP Files Panel appears. 


Import Wizard 


Marimba NCP File Information 
Specify the Marimba NCP file. lkm] 


Select a Marimba's Native Channel Packager (NCF) file and click Next to continue. 


NOP File: 


C:\AdminStudio Shared\AcrobatReaderS_Marimba\signed\.ncp\manifest.ncp | 


4. Click Browse and locate the directory containing the manifest.ncp file that you are importing. 


The Marimba NCP file that should be imported into ConflictSolver is always named manifest.ncp. If you 
attempt to import another file with an .NCP extension into ConflictSolver, the import will fail. 
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5. Click Next. The Destination Group Panel appears. 


Import Wizard 


Destination Group 
Specify the destination group for your installer package. 


Select one or more destination groups into which your package will be imported. 


= DG Groups 

EG Accounting 
OG Marketing 

ae 


ETR mE Ee (tee) 


Import Wizard 


Summary 
Review your options. 


Native Channel Packager File: 
manifest.ncp 


Mi 
2) 


Click Finish to accept these options. 


7. Review the information in the Summary Panel. If you are satisfied with the import options, click Finish to 
start the import. 


A report of the import process appears on the Import tab of the Output window. The Marimba NCP File 
package appears under the specified group in the products explorer. 
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You can also import a Marimba NCP File by rightclicking the group into which you want to import the package, 
pointing to Import, and selecting Marimba NCP File. The Marimba NCP Files Panel is displayed in the Import Wizard, 
and you can proceed with the steps above. However, since you have already specified the group into which you want 
to import the package, the Destination Group Panel does not appear. 


Importing Other Setup Types 


To import Other Setup Types into ConflictSolver, select the Other Setup Type option on the Import Data Types 
Panel of the Import Wizard. 


@)—. 


Remote Package Alert, Application Catalog Replication, reporting, validation, conflict detection, and thus conflict 
persistence are not supported by the Other Setup Types package type. However, the Merge process does support this 
package type. 


To import Other Setup Types into ConflictSolver: 


1. Select Import File from the Catalog menu. The Import Wizard Welcome Panel opens. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages [MSI], transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import your 
OS snapshots (OSC), Marimba Native Channel packager 
(NCP] and other non-MSI based setup programs. 


Click 'Next' to continue. 
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2. On the Import Wizard Welcome Panel, click Next. The Import Data Types Panel opens. 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press 'Next' to continue. 


Import Data Types 
| Other Setup Types 


Description 


4 wide variety of other (i.e. non-MSI) setup formats exist. By importing these other setup 
formats, you allow AdminStudio to manage these setups in a manner consistent with other 
MSI based packages. 


| 
3. Select Other Setup Types and click Next. The Other Setup Installation Files Panel appears. 


Import Wizard 


Other Setup Installation Files 
Specify the location for the other setup installation files | 


Provide a name for the setup and a directory containing the setup files to import and click ‘Next’ 
to continue. 


Product Name |Marketing Applicatior| 


Directory C:\MyPackages 


Include entire directory hierarchy 


Cra Jones) (tones) (he) 


4. Enter a Product Name for this setup. 


5. Click Browse next to the Directory text box and locate the directory containing the setup files that you 
are importing. 


6. If you want to import all the files in the specified directory folder and all of its subfolders, select the 
Include entire directory hierarchy checkbox. If you want to import only the files in the root of the 
specified directory folder, do not select this option. 
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7. Click Next. The Destination Group Panel appears. 


Import Wizard 


Destination Group 
Specify the destination group for your installer package. 


Select one or more destination groups into which your package will be imported. 


= DG Groups 

EG Accounting 
OG Marketing 

ae 


(cask mE Ee (tee) 


Import Wizard 


Summary 
Review your options. 


“Other Setup’ Installation Type Information 
Setup Name: Marketing Application 
Directory: C:\MyPackages 
Import hierarchy? = ‘Yes 


Destination group(s) for the package: 
Research 


Mi 
2 


Click Finish to accept these options. 


9. Review the information in the Summary Panel. If you are satisfied with the import options, click Finish to 
start the import. 


A report of the import process appears on the Import tab of the Output window. The Other Setup Type 
package appears under the specified group in the products explorer. 
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You can also import Other Setup Types by right-clicking the group into which you want to import the package, pointing 
to Import and selecting Other Setup Types from the context menu. The Other Setup Installation Files Panel is displayed 

in the Import Wizard, and you can proceed with the steps above. However, since you have already specified the group 
into which you want to import the package, the Destination Group Panel does not appear. 


Specifying Duplicate Package Identifiers 


When you import a package into the ConflictSolver Application Catalog database, ConflictSolver checks specific 

identifiers that are selected on the Duplicate Package Tab of the Options Dialog to determine if that package has 
already been imported (PackageCode, ProductCode, Product Language, ProductVersion, List of Transform Files, 
ot—if no identifiers are selected—Product Name). 


Options 


| General | Import Validate | Resolution | Conflicts 
| Extended Attributes | Duplicate Package 


Duplicate Package Identification Options 


O 


[¥] ProductCode Property 


[C Product Language 
[C] Product Version 
[V] List of Transform Files 


Cancel Help 


If ConflictSolver determines that you are attempting to import a duplicate package (based upon the selected 
identifiers), the Product Name Change Dialog appears, where you are given the opportunity to enter a name of your 
choosing to identify the duplicate package before the package is imported. 


E Product Name Change 


The duplicate package detection process has identified this package as a 
duplicate of another package. By specifying a unique product name, you 
can proceed with the package importation. 


Product Name 


Microsoft Corporation_Orca 


Cancel Help 


InstallShield Software Corporation © 2004 722 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


Example of Importing a "Duplicate" Package 


You might encounter this situation if you are importing the same package into the ConflictSolver database multiple 
times, each time with a different set of transformations. One common reason why you might want to import the same 
package into your Application Catalog database more than once would be if you wanted to use AdminStudio Tuner to 
create custom installation SKUs of a common MSI package to distribute to different departments in your 
organization, each installation including certain features that are appropriate for the department and excluding certain 
features that are not appropriate. For example, if you were distributing a copy of Microsoft Office, you could add 
transforms to the Microsoft Office MSI package so that: 


m Accounting's installation would include only Word and Excel 
m Marketing's installation would include only Word and PowerPoint, and 


m Development's installation would include only Word and Access. 


Therefore, you might want to import the same package into your database more than once, each time with a different 
set of transformations. What happens when you import the package the second time depends upon the identifiers you 
selected on the Duplicate Package Tab. In this example: 


= If you select the List of Transform Files and ProductCode identifiers on the Duplicate Package Tab of the 
Options dialog, ConflictSolver will not identify these two packages as duplicate, even though they have the same 
ProductCode, because they have a different set of transformations. Therefore, the Product Name Change dialog 
will not appear, and the package will be imported with the same display name as the first package. 


E If you only select the ProductCode identifier on the Duplicate Package Tab of the Options dialog, ConflictSolver 
will identify the second package as a duplicate because the two packages have the same ProductCode, and the 
Product Name Change dialog will appear. 
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To identify duplicate package characteristics: 


1. Select Options from the Tools menu. 


2. On the Options Dialog, click the Duplicate Package tab. 


Options 


General Import | Validate 


Extended Attributes 


Duplicate Package Identification Options 


m] 


F] 


Product Language 
Product Version 


List of Transform Files 


Resolution Conflicts 
Duplicate Package 


Cancel Help 
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3. Select the identifiers that you would like to use for product imports by selecting one or more of the 
following options: 


m PackageCode Property — Identifier of package product was installed from. No two non-identical 
.msi files should ever have the same package code. 


ProductCode Property —Unique identifier for the particular product release, represented as a 


string GUID, for example {12345678-1234-1234-1234-12345678901 2}. 


= Product Language -—The language the installer should use for any strings in the user interface that 
are not authored into the database. 


m ProductVersion—Version of the product in string format. The format of the string is: 
major.minor. build. 


m List of Transform Files—A list of the transformations associated with this package. 


m [None Selected]—If you do not select any of these five identifiers, ConflictSolver checks the Product 


Name identifier to determine if a package is a duplicate. 


4. Click OK to save your changes and exit the Options dialog 


5. Proceed with the package import, as described in Importing Windows Installer Packages. 
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If ConflictSolver is performing a bulk import or reimport, it still identifies duplicate packages using the user-specified 


criterion. ConflictSolver will generate a unique displayed product name and allow the import to proceed without 
prompting the user. 


Z 


The options that you select on the Duplicate Package Tab of the Options dialog apply globally to all packages that you 
attempt to import; you cannot apply different identifiers to different packages. Also, since these options are saved in the 


AdminStudio Shared Directory, everyone using AdminStudio at your organization will share the same Duplicate 
Package options. 
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Merging Application Catalogs Using the 
Merge Wizard 


In some citcumstances, you may need to merge ConflictSolver information from two Application Catalogs. The 
reasons for this can vary, but usually involve increasing the number of packages available for conflict identification or 
the necessity of having the same data available in multiple geographic locations. 


O 


To merge ConflictSolver data from two Application Catalogs: 
1. Open the Application Catalog that is to contain the combined data. 


2. From the Catalog menu, select Merge to open the Merge Wizard. The Welcome Panel opens. 
Merge Wizard 
Welcome to the Merge Wizard. 


This wizard will guide you through the process of 
merging application data from another Application 
Catalog. 


Click Next to continue. 
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3. From the Welcome Panel, click Next. The Source Application Catalog Panel opens. 


Merge Wizard 
Source Application Catalog 


Specify the source Application Catalog to merge. 


Specify the source application catalog that contains the data to be merged. Click Next to 
continue. 


Source Application Catalog Type: 


Microsoft Access 


Source Application Catalog: 
C:\AdminStudio Shared\HoweApplicationCatalog.mdb 


Application Catalog version '5.5' 


4. From the Source Application Catalog Panel, select whether you want to import data from a Microsoft 
Access-based or SQL Server-based Application Catalog. 


5. Click Change to either browse to the Access-based Application Catalog or connect to the SQL Server- 
based Application Catalog (using the SQL Server / MSDE Login Dialog). 


6. Click Next to advance to the Groups Panel. 


Merge Wizard 


Groups 
Select the application data to merge 


Specify the application data to be merged. Click Next to continue. 


EEDI] Groups 
OG ACEOSContflict v1.00.0000 


a- ACETests 

OG Adobe 

DemoPlayer v1.00.0000 
InstallShield AdminStudio v5.01 
McAfee VirusScan v4.5.0 
Nartco_ACEO6 Two v1.00.0000 
OmniPage Pro 10.0 ¥10.0.0.0 
PackageForTheWeb 4 v4.0.0 
(Fh PackageForThew'eb 4 v4.0.0 


Replace duplicate application data 


Cs Jue) (tones) (He) 


7. From the Groups Panel, select the groups you want to merge. You can also select to replace duplicate 
application data. 
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8. Click Next. The Progress Panel opens. 


Merge Wizard 


Progress 
Merging 


Merge progress: 


Friday, January 09,2004 04:17:33PM 
Merge process started: 


Source Application Catalog : 'HoweT echnology.mdb' 
Destination Application Catalog: 'testlabsql2k (HowePublisher2004) - sa’ 


C:\AdminStudio Shared\PackageForl heWeb 4. msi 

Import started at: Friday, January 09, 2004 - 4:17 PM _.. 

Source package: C:\AdminStudio Shared\PackageF orl heWeb 4.msi 
Importing table ‘ActionT ext"... 


e 


9. In the Progress Panel, you can view the merge progress. Click Finish to exit the Wizard. 


For a comparison of the three methods for sharing Application Catalog Data in AdminStudio, see Sharing Application 
Catalog Data. 
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Using Remote Package Alert to Link to 
Remote Application Catalogs 


Por a large distributed enterprise, accurate and synchronized data is required for shared MSI packages. If a corporate 
level team maintains a database of packages used through out the corporation in New York, then all the regional 
offices should be able to link to the corporate level MSI packages and get the different pieces of data. 


ConflictSolver's Remote Package Alert feature allows you to link to MSI packages in a remote Application Catalog, 
import the data into your local Application Catalog, and maintain consistency between the packages. To update the 
contents of your local Application Catalog with the data on the remote Application Catalogs that you are linked to, 
you can choose to Refresh package data. 


ConflictSolver can link to one or multiple Application Catalogs, and can link to one or multiple packages within those 
Application Catalogs. This enables you to maintain multiple Application Catalogs that match your corporate 
organization and optimize the performance of AdminStudio. 


When you link to a remote package, ConflictSolver connects to the linked remote application catalog and imports an 
MSI package into the local application catalog. In order for Remote Package Alert to work properly, both the remote 
application catalog and the remote MSI file must be accessible to the linked users at all times. In other words, both the 
remote application catalog and all of the MSI files that have been imported into it must be able to be accessed by 
linked users via a shared network drive. 


Remote Package Alert can only be performed by a AdminStudio users with Administrator permission. For all other users, 
the Remote Package Alert options will be disabled. 


@ 


For a comparison of the three methods for sharing Application Catalog Data in AdminStudio, see Sharing Application 
Catalog Data. 
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Linking to a Remote Application Catalog 


To use the Remote Package Alert feature, you must have AdminStudio Administrator permission. For all other users, the 
Remote Package Alert options will be disabled. 


To link to a remote application catalog: 


1. On the Catalog menu, point at Remote Package Alert and select Remote Package Alert. The Remote 
Application Catalogs Dialog appears. 
Remote Application Catalogs 


Remote Application Catalogs: 


Server Application Catalog 


Remove 


Properties 


2. Click Add. The Remote Package Alert Wizard Welcome Panel appears. 


Remote Package Alert Wizard 


Welcome to the Remote Package Alert 
Wizard 


This wizard will guide you through the process of 
creating a new link to a remote application catalog. 


Click Next to continue. 
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3. Click Next. The Remote Link Application Catalog Panel appears. 


Remote Package Alert Wizard 


Remote Link Application Catalog 
Specify the Application Catalog to remotely link 


Specify the application catalog that is to be linked remotely. Click Next to continue. 


Remote Application Catalog T ype: 


| Microsoft Access 


Remote Application Catalog: 
|C:\AdminStudio Shared\HoweT echnology.mdb ez 


(cise Jue) (exes) (Hoe) 


4. From the Remote Application Catalog Type list, select the type of database of the application catalog 
you want to link to: 
= Microsoft SQL Server / MSDE or 
m Microsoft Access 

5. In the Remote Application Catalog text box, specify the name and path of the application catalog you 
want to link to. 
= Microsoft Access—Click Change to browse to the location of the application catalog. 


m Microsoft SQL Server / MSDE—Click Change to access the SQL Server / MSDE Login Dialog 
where you can logon to a database. 


When you open ConflictSolver, by default ConflictSolver will attempt to connect to your SQL Server 
Application Catalog using NT authentication mode. If that fails, ConflictSolver will display the SQL Server / 
MSDE Login Dialog and prompt you for a Server, Login ID, Password, and Database. 


If you use SQL Server Authentication Mode to login to your SQL Server Application Catalog, ConflictSolver 
will not save SQL login information. Therefore, each time you want to refresh the data from this application 
catalog, you will have to supply ConflictSolver with the login information. Therefore, it is recommended that 
you use NT authentication mode to login to SQL Server Application Catalogs. 
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6. Click Next. The Groups Panel appears. 


Remote Package Alert Wizard 


Groups 
Specify the application catalog data to be remotely linked 


Specify the application data to be remotely linked. Click Next to continue. 


EROI] Groups 
O ACEO6Conflict v1.00.0000 
a- 6 ACETests 
W 


OG Adobe 
CE DemoPlayer v1.00.0000 
O InstallShield AdminStudio v5.01 
OG McAfee VirusScan v4.5.0 
CIF Nattco_ACEO6 Two v1.00.0000 
OmniPage Pro 10.0 v10.0.0.0 
PackageForTheWeb 4 v4.0.0 
PackageForTheWeb 4 v4.0.0 
a-f Patch Mi 


Lisa JL ner J (coe) ETE 


7. Select the packages within an application catalog that you want to link to. 


8. Click Next. The Summary Panel appears. 


Remote Package Alert Wizard 


Summary 
Review your remote package alert options. 


Remote Server 
C:\AdminStudio Shared\HoweT echnology.mdb 


Remote Packages 
Groups 
PackageForT heWeb 4 


Click Finish to create the remote package alert. 


a re 
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9. Review the summary of the options that were selected in the previous panels of the Wizard. Click 
Finish. You are returned to the Remote Application Catalogs Dialog and the new remote package link is 


now listed. 


Remote Application Catalogs 


Remote Application Catalogs: 


Server 


Application Catalog 
C:\AdminStudio Shared\HoweTechn... 


Remove 


Properties 


10. If you want to specify option settings that directly affect the way linked data will be refreshed, select 
click Properties on the Remote Application Catalogs Dialog. The Remote Package Alert Properties 


Dialog appears. Click on the Options tab. 


Remote Package Alert Properties 


= 
| Groups | Options | 


Refresh Options 


Delete package when the source package is deleted 


m Update package when its source is modified 


[ox } [cancel] (Hee), 


11. On the Options tab, select one or more of the following Refresh Options: 


m Delete package when the source package is deleted 


12. Click OK to close the Remote Package Alert Properties Dialog and then click OK to close the Remote 
Application Catalogs Dialog. 
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Editing a Link to a Remote Application Catalog 


On the Groups tab of the Remote Package Alert Properties Dialog, you can link or unlink to different packages 
within an Application Catalog. 


To use the Remote Package Alert feature, you must have AdminStudio Administrator permission. For all other users, the 
Remote Package Alert options will be disabled. 


g> 
8, 
To edit a remote package link: 


1. On the Catalog menu, point to Remote Package Alert and select Remote Package Alert. The Remote 
Application Catalogs Dialog appears. 


Remote Application Catalogs 


Remote Application Catalogs: 


Server Application Catalog 


C:\AdminStudio Shared\HoweTechn... 
Remove 


Properties 


Cancel 
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2. Select the remote application catalog link that you would like to edit and click Properties. 


The Groups tab of the Remote Package Alert Properties Dialog appears, displaying the 
groups/packages in the selected remote application catalog that you can link to. Any package that is 
already linked to will display the checkbox as selected. 


Remote Package Alert Properties 


Groups | Options 


Leek Groups 
DEA ACEO6Conflict v1.00.0000 


D ACETests 

OG Adobe 

OE DemoPlayer v1.00.0000 

OG InstallShield AdminStudio v5.01 

McAfee VirusScan v4.5.0 

Nartco_ACEO6 Two v1.00.0000 

OmniPage Pro 10.0 v10.0.0.0 
PackageForT heWeb 4 v4.0.0 

G PackageForTheWeb 4 v4.0.0 

( Patch 

© Subscribed 

Symantec Act! v4.0.0 

© Transforms 


O00000 


Cancel Help i 


3. Select or deselect checkboxes to link or unlink to packages within this remote application catalog link. 


4. |f you want to specify option settings that directly affect the way linked packages will be refreshed, click 
the Options tab, and select one or more of the following Refresh Options: 


m Update package when its source is modified 


m Delete package when the source package is deleted 
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Remote Package Alert Properties 
Groups | Options 


Rel 


Delete package when the source package is deleted 


5. Click OK to close the Remote Package Alert Properties Dialog and then click OK to close the Remote 
Application Catalogs Dialog. 


Refreshing a Linked Package 


Use the Refresh menu item (On the Catalog menu, point to Remote Package Alert and select Refresh) to update the 
linked package of the local Application Catalog with the same package in the remote Application Catalog. When you 
click on Refresh, how the packages are refreshed depends upon which options you have selected on the Remote 
Package Alert Properties Dialog: 


Option Description 


Update package when If you have selected this option, ConflictSolver will go and check if any of the linked 
its source is modified packages have been modified in the Application Catalog. 


a If the linked package has been modified, then the local Application Catalog database 
is updated to reflect the changes. 

= If the linked package has not been modified, you receive a message stating that "No 
refresh is necessary". 


If you have not selected this option, ConflictSolver will still check to see if any of the 
linked packages have been modified: 


= lf the linked package has been modified, ConflictSolver will inform you that the source 
package has been modified but that it will not update the local Application Catalog 
database because this option is not selected. 


a If the linked package has not been modified, you receive a message stating that "No 
refresh is necessary". 
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Option Description 


Delete package when If you have selected this option, ConflictSolver will delete any linked data in the 
the source package is local database if the data is deleted from the remote database. 


deleted If you have not selected this option, even if the source package is deleted in the 


remote database, your copy of the package will not be deleted. 


As the linked packages are being refreshed, output messages will be displayed in the Remote Package Alert tab of the 
ConflictSolver Output window. 


You can select one, both, or neither of these Refresh options. 


This menu item will refresh all the new or modified remote packages, so clicking on this menu item can be a time 
consuming operation. 


To use the Remote Package Alert feature, you must have AdminStudio Administrator permission. For all other users, the 
Remote Package Alert options will be disabled. Also, if there are currently no remote package links defined, the Refresh 
option will be disabled. 
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Deleting a Link to a Remote Package 
ArT 
ei 
To delete a link to a remote package: 


1. On the Catalog menu, point to Remote Package Alert and select Remote Package Alert. The Remote 
Application Catalogs Dialog appears. 


Remote Application Catalogs 


Remote Application Catalogs: 


| Server Application Catalog 


C:\AdminStudio Shared\HoweTechn... 
Remove 


Properties 


Cancel 


2. Select the remote package link that you would like to delete and click Remove. 


Once the remote package link is deleted, the database name and all the packages that are currently linked to will be 
deleted from the Remote Application Catalogs Dialog. 


Viewing Remote Package Links on the Products 
Explorer 


The products explorer shows all the groups and packages present in an Application Catalog. The groups and packages 
that have been linked to using the Remote Package Alert Wizard are displayed using a special icon, as shown below: 


Catalog Yiew Conflicts Reports Tools Help 


C8 BVH CBRE AO 


= © Groups 
E-E] DemoPlayer (v1.00,0000) 
E-E] InstallShield Developer (v8.01.016) 
co Jasc Software Inc_Paint Shop Pro 7 Anniversary Edition (v7.0.4,.0000) 
aw Norton Antivirus Corporate Edition (v7,5.0.0) 
& Orca (v1,50,2600,0000) 
E>) PackageForThewWeb 4 (v4.0.0) 
H-H WindowsXP 


If a linked package been updated on the remote Server and needs to be refreshed in order to update its data with the 
data on the local Server, an exclamation point appears next to the Remote Package Link icon: 


R 
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Validating Packages 


Validation 


An important first step in conflict identification and resolution is to validate the original Windows Installer package. 
Validation compares the package against known Windows Installer standards to ensure it is built to those 
requirements. Ideally, all packages that you import into ConflictSolver will pass validation—trealistically, that will not 
be the case. ConflictSolver allows you to import any Windows Installer package into ConflictSolver, regardless of 
whether it has passed validation or not. However, should you import a Windows Installer package that does not pass 
validation, potential issues may arise due to the package not having been authored to Microsoft standards. 


Validating Windows Installer Packages 


(gà 


Bi 
To validate a Windows Installer package: 


1. Select Validation Wizard from the Conflicts menu. The MSI Source Information Panel of the Validation 
Wizard opens. 


Validation Wizard 


MSI Source Information 
Specify the MSI file along with any transforms, 


Specify a Windows Installer package (.msi) and any associated transforms (.mst). Click Next 
to continue, 


Select an MSI file: 
C:\AdminStudio Shared\Orca.msi 


‘Transforms (.mst): 


\AdminStudio Shared\Orcal mst 


2. Specify or browse to the Windows Installer package you want to validate. 


transforms, you can move the transforms up and down to change the order in which they are applied to 
the base package (which can affect validation). 
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4. Click Next. The Summary Panel opens. 


Validation Wizard 


Summary 
Review your options. 


MSI/MST file name to validate: 
C:\AdminStudio Shared\Orca.msi 


List of transforms to validate. 
C:\AdminStudio Shared\Orcal.mst 


Click Finish to accept these options. 


5. Review your options in the Summary Panel. Click Finish to begin validation. Output appears in the 
Validate tab of the Output window. 


You can also perform validation when importing a package using the Import Wizard. 


9)— 


Should the package contain validation errors, you may be able to correct them using Tuner or DevStudio. 


Changing the Default Validation File 


Validation involves comparing a Windows Installer package against a known criteria to identify deviations from those 
tules. By default, ConflictSolver compares packages against the Full MSI Validation Suite. This suite contains a 
comprehensive set of Internal Consistency Evaluators (ICEs)—guidelines created by Microsoft to ensure an 
installation package works correctly with the Windows Installer engine. In the overwhelming majority of cases, this is 
the file you will want ConflictSolver to use. However, there may be times you want to compare your base package 
against a different validation file, depending on your needs. 
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To specify a different validation file to use: 
1. Select Options from the Tools menu. The Options Dialog opens. 


2. Select the Validate tab from the dialog. The Validate tab opens. 


Options 


Extended Attributes I Duplicate Package | 


Validate | Resolution || Conflicts | 


C Info 


MSI Input files 
Cub File: [C:\Program Fites\InstalShield\AdminStudio\5.5\Confict(..} 


ICE Rules: | | 


MSM Input files 
Cub File: [C:\Program Files\InstallShield\AdminStudio\5.5\Confii | (...] 


ICE Rules: | 


Separate multiple ICE rules with a semicolon {;). 


3. Click Browse (...) to locate a validation file (.cub). 


4. |f necessary, specify the validation rules to perform, delimited by semicolons (;). Otherwise, all rules will 


be used. 
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Validating Packages During Import 


To validate a package during import: 


1. Select Options from the Tools menu. The Options Dialog opens. 


2. Select the Import tab from the dialog. The Import tab opens. 


Options 


Extended Attributes 


General Import Validate 


Options 

Check for Validation Errors 
ts 

Import Binary Data 

Import Custom Tables 

C] Abort on Fatal Error 


Ignore Tables 


Duplicate Package 


Resolution 


Conflicts 


| Table Name 


3. Select the Check for Validation Errors check box. 


4. Click OK. 


Comments 


From this point, when you import a package into ConflictSolver, validation will automatically be performed. If you 
select to validate a package on import, and if the package fails validation, the package will not be imported into 


ConflictSolver. 
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Handling Invalid Windows Installer Packages 


Ideally, all Windows Installer packages will pass validation. Realistically, many will fail. When a package fails validation, 
it means the package was not built to Microsoft's specifications. It does not mean the installation does not work. 
However, there are a few things you can do when your package has validation errors: 


Solution 


Explanation 


Use Tuner to correct 
validation errors. 


This involves opening the base package using Tuner and creating a transform file which 
contains your corrections. The same validation tool is available in Tuner. 


Contact the installation 
vendor. 


The company that created the installation (usually the same company that created the 
software) may be able to resolve the validation issues and provide you with a valid setup. 
Be sure to provide the validation report to vendors so they know where to focus. 


Reconsider using the 
application. 


Although it might be an extreme reaction to an invalid package, there may be compelling 
reasons not to use an installation not built to Microsoft guidelines. 


Ignore the problems 
and import the 
package into 
ConflictSolver anyway. 


This is probably the most likely scenario. The invalid installation may not be worth trying to 
fix, or even have errors that you are concerned about. ConflictSolver allows you to import 
an installation package regardless of its validity; just know that there could be problems in 
the future in doing so. From a practical standpoint, this may be your best option. 
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Changing Default Validation Options 


fam 


Bi 


To change default validation options: 


1. Select Options from the Tools menu. The Options Dialog opens. 


2. Select the Validate tab from the dialog. The Validate tab opens. 


Options 


Extended Attributes 
General || Import Validate 


Cl Info 


MSI Input files 


Duplicate Package 


Resolution Conflicts 


Cub File: 


[C:\Program Files\InstallShield\AdminStudio\5.5\Contlct|(... 


ICE Rules: 


MSM Input files 


| 


Cub File: 


[C:\Program Files\InstallShield\AdminStudio\5.5\Contl | [...] 


ICE Rules: 


Separate multiple ICE rules with a semicolon {;). 


3. Make the necessary validation option changes and click OK. 
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ICEs and Validation Errors 


Why do I get ICE43/ICE50/ICE57 warnings or errors when I 
validate my .msi? 


Overview 


Each entry in the CreateLink section of the .inc file is converted into an entry in the Shortcut table. The exact 
properties of the shortcut depends upon the information in the CreateLink line as well as the nature of the target file 
itself. 


ICE 43, ICE 50, and ICE 57 are the most common validation rules for shortcuts. 


Shortcut Types 


The primary distinction between shortcuts is advertised vs. non-advertised. here are two reasons why it is preferable 
to create advertised shortcuts: 


1. Advertised shortcuts are triggers for MSI's self-repair mechanism. 
2. Non-advertised shortcuts are intended for a per-user context only: 
a. The target file must be a file installed in a user-specific directory. 


b. The keypath of the component containing the target file must be a user-specific registry value. 


Conversion from CreateLink entries to Shortcut Table Entries 


The .inc converter will always try to create advertised shortcuts for every CreateLink line found in the .inc file. 
However, not every CreateLink line can be converted into an advertised shortcut. 


In order to create an advertised shortcut, the information in the CreateLink line must meet all of the following 
requirements: 


1. The target file must be the keypath of its component. This means that the target file must be listed in the 
.inc file list. The converter will create a new component for a non-PE target files, so that it is guaranteed 
to become the keypath of the component. (Normally, for each target directory, non-PE files are grouped 
together into one component). 


2. The target file must contain an icon. 


In general, this means that as long as the target file contains an icon, the converter will be able to create an advertised 
shortcut for it. However, whenever a shortcut cannot be advertised, the converter does the following: 


1. It creates a "catch all" component (if not yet created) named "ShortcutsComponent." It also creates an 
HKCU registry entry in the Registry table, and that entry is used as the keypath for the 
ShortcutsComponent. This is done to avoid ICE43. 


2. A new shortcut entry is created in the Shortcut table, associated with the ShortcutsComponent. 
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Identifying and Resolving Conflicts 


Conflict Identification and Resolution 


Conflict identification occurs if you import a package into ConflictSolver using the Import Wizard, providing the 
Check for Conflicts option has been selected in the Import Tab of the Options Dialog. ConflictSolver checks for 
conflicts using the default rules specified in the Conflicts Tab of the Options Dialog. 


You can also identify conflicts using the Conflict Wizard. From the Source Type Panel, you can select whether you 
want to check an external Windows Installer package against packages in ConflictSolver, or check a package already in 
the ConflictSolver against others in ConflictSolver. 


e e 
Setting Options 
You can set the following ConflictSolver conflict identification and resolution options: 


E Changing Default Conflict Types Checked—Select the ACE rules that will be selected by default during 
conflict detection. 


m Changing Resolution Options—Specify whether you want to save resolutions in the original MSI package or 
in a transform file. 
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Changing Default Conflict Types Checked 


To change default conflict types checked: 


1. Select Options from the Tools menu. 


2. Click the Conflicts tab from the Options dialog. 


Options 


= Extended Attributes | Duplicate Package 
General | Import Validate || Resolution | Conflicts 


Suppress 
CWarnings Enfo 


Predefined and Custom ACE Rules 


= EG Conflict Types 
aC Components 
I) File Extensions 
H- Files 
{li INI Files 
H- NT Services 
-C6 ODBC Resources 
-C Product Properties 
GS Registry 
Je Shortcuts 


tlle teal as 


|C:\AdminStudio Shared\ConflictS olver\CustomConflictFile. ace | 


3. Select the default conflicts you want to check for from the Predefined and Custom ACE Rules area. 


4. Click OK. 


12 Identifying and Resolving Application Conflicts 


The ACE tules associated with each conflict type are described in the table below: 


Conflict Type Associated Rules 

Component ACE02, ACEO4, ACEO5, ACEO6, ACEO9 
Files ACE03, ACEO7, ACEO8, ACE12, ACE23 
Registry ACE10, ACE24 

Shortcuts ACE13 
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Conflict Type Associated Rules 

INI Files ACE14, ACE21, ACE22 
ODBC Resources ACE15 

NT Services ACE16 

File Extensions ACE17 

Product Codes ACE18, ACE19, ACE20 


Changing Resolution Options 


You can change resolution options on a product-by-product basis. 


(m> 

Bi 

To change resolution options: 

1. From the products explorer, select the product for which you want to change resolution options. 


2. Select the Conflicts View for the product. The Conflicts View opens. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit Yiew Conflicts Reports Tools Help 


xi h= PackageForTheWeb 4 
5 & Groups "| conflict view 


{© Accounting ae 
{InstallShield Software Corporation_F STNG SSN AED 


{© Marketing Summary 

H-E Orca (v1.50.2600.0000) 

g fm PackageForTheWeb 4 (v4.0.0) When conflict identification was performed on ‘PackageForTheWeb 4' on ‘Monday, January 12, 2004 - 12:41 
RQ Conflicts PM’, a total of 3 conflict(s) were identified, of which 3 are automatically resolvable, by checking a total of: 


Ef Extended Attributes 


; Files/Components 1 product(s), 


INI File Changes using 25 ACE rule(s). 

Merge Modules None of these product(s) have been updated. 
w Registry None of these product(s) have been deleted, 
E Shortcuts No new product(s) have been added to the AdminStudio Application Catalog. 


on Tables Resolution Options 
Research 


The conflict resolution options for this package are to: 
Resolve Conflicts: Save the resolutions within a transform file, 
C:\AdminStudio Shared\PackageForTheWeb 41.mst 


You can modify these resolution options by selecting ‘Edit’. 


3. Ensure the Summary view is selected from the Conflict Information list. 
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4. In the Resolution Options area, click Edit. the Resolution Options Dialog opens. 


Resolution Options 


Save Options 


O Save resolutions in original MSI package 


© Save resolutions in a new transform file 


C:\dminStudio Shared\PackageForTheWeb 41,mst 


5. From the Resolution Options Dialog, select whether you want to save resolutions in the original MSI 
package or in a transform file. If you select a transform file, browse to or specify it. 


6. Click OK. 


Any resolutions you make are stored in the specified transform (if selected) or in the original package. By selecting the 
Perform resolutions against a transform file option in the Resolution Tab of the Options dialog, you can set the 
default behavior to store resolutions in a transform. 


You can only modify resolution options if persisted conflict data exists for a product. 
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Checking for Conflicts 


identifying Conflicts Using the Conflict Wizard 


The Conflict Wizard can be used to identify conflicts between an external Windows Installer package and ones already 
in ConflictSolver, or between one or mote packages in ConflictSolver. 


Identifying Conflicts with an External Package 


To identify conflicts between an external Windows Installer package and packages 
already in ConflictSolver: 


1. Select Conflict Wizard from the Conflicts menu. The Welcome Panel opens. 


Conflict Wizard 


Welcome to the Conflict Wizard 


The Conflict Wizard allows you to check for conflicts 
between an external Windows Installer package and 
other packages already stored in the AdminStudio 
Application Catalog. 


Click Next to continue, 
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2. Click Next. The Source Type Panel opens. 


Conflict Wizard 


Source Type 
Specify the source type. 


Select whether the source package is stored externally or within the Application Catalog, Click 
Next to continue. 


© 


Check for conflicts between packages within the AdminStudio Application Catalog. 


O Windows Installer package 


Check for conflicts between packages in the AdminStudio Application Catalog and 
external MSI file, 


i It is Faster to perform conflict detection between internal application packages 
than it is to check against an external Windows Installer package. To improve 
performance, run conflict detection between internal packages 


3. From the Source Type Panel, select Windows Installer package. Click Next. The MSI Source Information 
Panel opens. 


Conflict Wizard 


MSI Source Information 
Specify the MSI file along with any transforms, 


Specify a Windows Installer package (.msi) and any associated transforms (,mst), Click Next 
to continue, 


Select an MSI file: 


p e 


Transforms (.mst): 


4. From the MSI Source Information Panel, click Browse to locate the MSI file you want to check against 
packages in ConflictSolver. 
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button (...) to locate the transform. If the package requires multiple transforms, you can repeat the 
procedure as necessary. The order in which transforms are applied can be changed by selecting a 


transform and clicking | (Move Up) and +| (Move Down). If you need to delete a transform you 
have added, select the transform and click x| (Delete). 


6. Click Next. The Target Information Panel opens. 


Conflict Wizard 


Target Information 
Specify the target products, 


Select the groups or products against which you want to compare the source package for 
conflicts, Click Next to continue, 


a Me Groups 

VIGA InstallShield Software Corporation_PackageForTheWeb 4 v4.0.0 
MI orca v1.50.2600.0000 

FI PackageForTheWeb 4 v4.0.0 


7. From the Target Information Panel, select the packages in ConflictSolver you want to compare the 
package against. You can also select entire groups, which will compare the package against all 
packages and OS Snapshots in that group. 
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8. Click Next. The Conflict Options Panel opens. 


Conflict Wizard 


Conflict Options 
Specify the conflict options. 


Select the conflicts to detect and click Next to continue, 


a WG Conflict Types 
Ji) Components 

(© File Extensions 

© Files 

(© INI Files 

(© NT Services 

(© ODBC Resources 

(© Product Properties 

(© Registry 

S-E Shortcuts 


[C] Generate Reports 


9. From the Conflict Options Panel, select the types of conflicts you want to identify and click Next. The 
Summary Panel opens. 


Conflict Wizard 


Summary 
Review the conflict options. 


Source: 
C:\AdminStudio Shared\Orca.msi 


Checking for conflicts against: 
InstallShield Software Corporation_PackageForTheWeb 4 (4.0.0) 
Orca (1,50,2600,0000) 
PackageForThewWeb 4 (4.0.0) 


Conflict Selection Information: 
ACEOS 
ACEO? 
ACEOS 
ACE12 
ACE14 
ACE21 


arran 


Click Finish to identify conflicts, 
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10. Review the options selected in the Summary Panel and click Finish to begin the conflict identification 


process. Progress appears in the Output tab of the Output Window. 


!|Conflict identification started on: Monday, January 12, 2004 - 1:41 PM 


£/\Source conflict identification package: C:\AdminStudio Shared\Paint Shop Pro 7 Anniversary Edition.msi 


Checking For components with identical GUIDs installed to different destinations. 


Created 2/13/2001. Last Modified 11/15/2003 
Checking components with identical GUIDs for new and/or missing files. 
Created 2/13/2001, Last Modified 11/15/2003 

| 


Validate A, Conflicts A, Remote Package Alert 


Search Results 


When the conflict analysis is complete, all of the Errors and Warnings that were generated are listed in 


a table format in the Conflicts tab of the Output Window. 


Description 


The component 'NEUTRAL AMERA KC 


oMMON_C 
oMMON_CAME 
OMMON 


OMMON_CAMERA_K 


he component 'NE 


The component 'NEUTRAL_. 
\e component 'NEUTRAL_. 
n the comp 


file version '6.0,8797.0' of File 'msvert.dll' 


File $ 


Warning 1 


Warning T ersion '6.0.8 
The File ‘rr rt.dil’, siz 


m 


j 

he 
he 
he 
be 


e File 'mfc42.dll', size '995383' bytes 


0.8447 


AK_P 
DAK _A 
A _KODAK_é 
ADAK A 


nent 'Global_v¢ 


0', language 


\llOtherKODAK_CAMERAFiles' in the pack 

AERAFiles' in the pack 
_CAMERAFiles' 
sllOtherKODAK_CAMERAFiles' in the pack 
CRT.S1D569E0_G428_11D: 


42ANSICore.51D569E2. 


t 
\llOtherKC 
t 
t 


slOtherKe 


è in the pack 


sh (United States)’ installec 


‘installed 


> 


English (United States 


Conflicts A Remote Package Alert A Search Results F 


If a row is active, you can double-click on it to view that row's associated table. The Tables View is 
launched and the table and/or table cells that are causing the problem are highlighted in red. If a row 
is grayed out, it indicates that the table cannot be viewed in ConflictSolver (perhaps because it is in an 


external package). To resolve conflicts, see Resolving Conflicts. 
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Identifying Conflicts Between Existing Packages 


To identify conflicts between packages already in ConflictSolver: 


1. Select Conflict Wizard from the Conflicts menu. The Welcome Panel opens. 


Conflict Wizard 


Welcome to the Conflict Wizard 


The Conflict Wizard allows you to check for conflicts 
between an external Windows Installer package and 
other packages already stored in the AdminStudio 
Application Catalog. 


Click Next to continue, 


2. Click Next. The Source Type Panel opens. 


Conflict Wizard 


Source Type 
Specify the source type. 


Select whether the source package is stored externally or within the Application Catalog, Click 
Next to continue. 


Check For conflicts between packages within the AdminStudio Application Catalog. 


O Windows Installer package 


Check For conflicts between packages in the AdminStudio Application Catalog and 
external MSI file, 


i It is Faster to perform conflict detection between internal application packages 


than it is to check against an external Windows Installer package. To improve 
performance, run conflict detection between internal packages 
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3. From the Source Type Panel, select Internal Application Catalog package. Click Next. The Source 
Package Panel opens. 


Conflict Wizard 


Source Package 
Specify the source package. 


Select a source package to analyze For conflicts and click Next to continue. 


ERIE] Groups 
MI Orca v1.50.2600,0000 
MG PackageForTheweb 4 v4.0.0 


4. From the Source Package Panel, select the package(s) you want to compare against other package(s) in 
ConflictSolver. If you select multiple source packages, ConflictSolver will conflict check each source 
package serially against all of the selected target packages. 


5. Click Next. The Target Information Panel opens. 


Conflict Wizard 
Target Information 


Specify the target products, 


Select the groups or products against which you want to compare the source package for 
conflicts. Click Next to continue. 


a MG l 
vI InstallShield Software Corporation_PackageForTheweb 4 v4.0.0 


6. From the Target Information Panel, select all the packages you want to compare the source package 
against. (The Target Information Panel excludes all packages that you selected on the Source Package 


Panel.) 
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7. Click Next. The Conflict Options Panel opens. 


Conflict Wizard 


Conflict Options 
Specify the conflict options. 


Select the conflicts to detect and click Next to continue, 


a WG Conflict Types 
Ji) Components 

(© File Extensions 

© Files 

(© INI Files 

(© NT Services 

(© ODBC Resources 

(© Product Properties 

(© Registry 

S-E Shortcuts 


[C] Generate Reports 


8. From the Conflict Options Panel, select the types of conflicts you want to identify and click Next. The 
Summary Panel opens. 


Conflict Wizard 


Summary 
Review the conflict options. 


Source: 
Orca (1,50,2600,0000) 
PackageForThewWeb 4 (4.0.0) 


Checking for conflicts against: 
InstallShield Software Corporation_PackageForTheWeb 4 (4.0.0) 


Conflict Selection Information: 
ACEO3 
ACEO? 
ACEO8 
ACE12 
ACEZ3 
CustomRule1 
ACE14 


arras 


Click Finish to identify conflicts. 
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9. Review the options selected in the Summary Panel and click Finish to begin the conflict identification 


process. Progress appears in the Output tab of the Output Window. 


!|Conflict identification started on: Monday, January 12, 2004 - 1:41 PM 


£/\Source conflict identification package: C:\AdminStudio Shared\Paint Shop Pro 7 Anniversary Edition.msi 


Checking For components with identical GUIDs installed to different destinations. 


Created 2/13/2001. Last Modified 11/15/2003 
Checking components with identical GUIDs for new and/or missing files. 
Created 2/13/2001, Last Modified 11/15/2003 

| 


Validate A, Conflicts A, Remote Package Alert 


Search Results 


When the conflict analysis is complete, all of the Errors and Warnings that were generated are listed in 


a table format in the Conflicts tab of the Output Window. 


Description 


The component 'NEUTRAL AMERA KC 


oMMON_C 
oMMON_CAME 
OMMON 


OMMON_CAMERA_K 


he component 'NE 


The component 'NEUTRAL_. 
\e component 'NEUTRAL_. 
n the comp 


file version '6.0,8797.0' of File 'msvert.dll' 


File $ 


Warning 1 


Warning T ersion '6.0.8 
The File ‘rr rt.dil’, siz 


m 


j 

he 
he 
he 
be 


e File 'mfc42.dll', size '995383' bytes 


0.8447 


AK_P 
DAK _A 
A _KODAK_é 
ADAK A 


nent 'Global_v¢ 


0', language 


\llOtherKODAK_CAMERAFiles' in the pack 

AERAFiles' in the pack 
_CAMERAFiles' 
sllOtherKODAK_CAMERAFiles' in the pack 
CRT.S1D569E0_G428_11D: 


42ANSICore.51D569E2. 


t 
\llOtherKC 
t 
t 


slOtherKe 


è in the pack 


sh (United States)’ installec 


‘installed 


> 


English (United States 


Conflicts A Remote Package Alert A Search Results F 


If a row is active, you can double-click on it to view that row's associated table. The Tables View is 
launched and the table and/or table cells that are causing the problem are highlighted in red. If a row 
is grayed out, it indicates that the table cannot be viewed in ConflictSolver (perhaps because it is in an 


external package). To resolve conflicts, see Resolving Conflicts. 
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Checking for Conflicts During Import 


To check for conflicts during import: 


1. Select Options from the Tools menu. The Options Dialog opens. 


2. On the Options Dialog, click the Import Tab. The Import Tab opens. 


Options 


| Extended Attributes | Duplicate Package 
| General | Import Validate || Resolution || Conflicts 


Options 

Check for Validation Errors 
S 

Import Binary Data 

Import Custom Tables 

C] Abort on Fatal Error 


Ignore Tables 


| Table Name Comments 


Delete Delete All 


3. Select the Check for Conflicts check box. 
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4. Click the Conflicts Tab. The Conflicts Tab opens. 


Options 


__ Extended Attributes | Duplicate Package 


General || Import Validate || Resolution | Conflicts 


Suppress 


Cl Info 


Predefined and Custom ACE Rules 


S EG Conflict Types 
J Components 
a- File Extensions 
B-E Files 
wl INI Files 
C NT Services 
OG ODEC Resources 
CIG Product Properties 
Oe Registry 
OG Shortcuts 


an <a a] 


} 


f 


i) 


Custom ACE Rule File 


|C:\AdminStudio Shared\ConflictS olver\CustomConflictFile. ace ] 


5. Select the conflict types you want checked by default when importing packages. 
6. Click OK. 


12 Identifying and Resolving Application Conflicts 


From this point, when you import a package into the Application Catalog, the package will automatically be checked 
for conflicts against all packages already in ConflictSolver using the default ACE rules selected in the Conflicts Tab of 
the Options Dialog. Depending on how many packages already in ConflictSolver, and depending on the number of 
ACE rules selected by default, this can take a significant amount of time. You can override the conflict checking by 
deselecting the Run Conflicts check box from the MSI Source Information Panel in the Import Wizard. 
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Viewing Identified Conflicts 


To view identified conflicts: 
1. From the products explorer, select the product for which you want to view identified conflicts. 


2. Select the Conflicts 98 icon to view the Conflicts View for the product. 


The Summary view displays an overall summary of the conflicts identified, including the products this 
product was checked against for conflicts, the ACE rules used, and resolution options. 
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{£ Marketing Summary 
a] Orca (¥1,50,2600,0000) 
=) R PackageForTheWeb 4 (v4.0.0) When conflict identification was performed on ‘PackageForTheWeb 4' on ‘Monday, January 12, 2004 - 12:41 

iy Conflicts PM', a total of 3 conflict(s) were identified, of which 3 are automatically resolvable, by checking a total of: 


@ Extended Attributes 


3 Files}Components Lproduct(s), 


INI File Changes using 25 ACE rule(s). 


Merge Modules None of these product(s) have been updated, 


a Registry None of these product(s) have been deleted. 
E Shortcuts No new product(s) have been added to the AdminStudio Application Catalog. 


Tables Resolution Options 
{© Research 


The conflict resolution options for this package are to: 
Resolve Conflicts: Save the resolutions within a transform file, 
C:\AdminStudio Shared\PackageForTheWeb 41.mst 


You can modify these resolution options by selecting ‘Edit’. 


You can change the Conflict Information list at the top of the view to see individual conflict categories 
and perform resolution. See Resolving Conflicts for more information. 


You can also view conflicts generated from the comparison of an external package with those packages already in 
ConflictSolver by selecting Resolve External Package Conflicts from the Conflicts menu. The resulting Conflict Resolution 
Dialog displays conflict results from the last conflict execution for an external package. 
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Running Conflict Identification Again 


At times, it may be necessary to run conflict identification again on a package that you have previously checked for 
conflicts. This could be because other packages you previously compared this package against have changed. It may 
be because you have added additional packages to ConflictSolver. 


There are two ways to accomplish this. 


Em If you want to run conflict identification again using the same options as the last time you ran conflict 
identification on the package, you can do so by clicking the Run Again button from the package's Conflicts View. 


m In all other cases, use the Conflict Wizard to perform conflict identification. 


When you run conflict identification for a package on which you have previously performed conflict identification, the 
persisted conflict data is deleted and replaced with the new conflict data. 


Deleting Persisted Conflict Data 


g` 


B3 
To delete persisted conflict data from a package: 


1. Right-click on the package in the products explorer, point to Delete, and select Persisted Conflict 
Information. 


2. Confirm the deletion. 


Conflict Persistence 


ConflictSolver automatically persists conflict information for packages in ConflictSolver, and for the last execution of 
the Conflict Wizard between an external package and packages already in ConflictSolver. This enables you to run 
conflict identification between packages without having to perform the resolution immediately. 


Your workflow may, for example, dictate that you import several packages into ConflictSolver first (placing them in 
some sort of staging group) and then perform conflict identification on them all at once. Resolution of identified 
conflicts may be much later in the workflow. ConflictSolver assists you by retaining the conflict information until you 
ate ready to work with it. 


Each package in ConflictSolver includes a Conflicts View, where this persisted conflict data can be accessed. You can 
see when conflict identification was performed, between which packages, using which ACE rules, and the result. You 
can also see which packages have been updated, added to, or deleted from ConflictSolver since conflict identification 
was performed. 
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Resolving Conflicts 


Conflict Resolution Process 


After conflict analysis is performed, either by using the Conflict Wizard or by checking for conflicts during import, all 
of the Errors and Warnings that were generated are listed in the Conflicts tab of the Output Window a table format. 
You can resolve these conflicts by clicking Resolve or Resolve All on the Conflicts View. However, the Conflict 
Resolution Process differs depending upon options you select on the Resolution Tab of the Options Dialog. 


Options 


“Extended Attributes || Duplicate Package _ 


General || Import Validate | Resolution | Conflicts 


Initial Resolution Locati 


Resolution Options 
Preview and approve all resolutions 
Maximize user flexibility in selecting resolutions 
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Review and Approve Conflicts 


The selection you make in the Preview and approve all resolutions field on the Resolution Tab of the Options Dialog 
determines if you will be prompted to review resolutions before they are executed. 


m Ifthe Preview and approve all resolutions option is selected, the Resolution Details Dialog appears when you click 
Resolve or Resolve All on the Conflicts View. 


Resolution Details 


The CARD resolutions will execute the following changes to the package. Please approve the 
changes before the resolution process can be completed. 

CARD Details 

Information Details 


Sacarp19 Update the 'ProductCode' property with a newly generated GUID, 
SScarv20 Update the 'UpgradeCode' property with a newly generated GUID. 


[Don't show this dialog again 


This dialog lists the proposed CARD resolutions that will be made to the package. Only the CARD resolutions 
that are selected when you click Approve will be executed. 


mE Ifthe Preview and approve all resolutions option is not selected, the Resolution Details Dialog will not appear, and 
all selected conflict resolutions will be executed. 


m If the Resolution Details dialog appears but you no longer want it to, select the Don't show this dialog again 
checkbox. This is equivalent to unselecting the Preview and approve all resolutions option on the Resolution tab 
of the Options dialog. 


Ifa CARD can be resolved in multiple ways, and if the Maximize user flexibility in selecting resolutions option is 
selected on the Resolution Tab of the Options dialog, the CARD Resolution Options Dialog appears, prompting you 
to make a selection to determine how conflict resolution will proceed. The following CARD can be resolved in 
multiple ways: 


=m CARDO6—ACE06 accumulates a list of potential files to be used for the KeyPath. The CARD Resolution 
Options Dialog appears, prompting you to choose one file from the list of potential files. 
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Automatically Resolving Conflicts 


If the Conflict Wizard identifies conflicts, ConflictSolver may be able to resolve some of them automatically (ACE02, 
ACE04, ACE05, ACE06, ACE07, ACE15, ACE18, ACE19, and ACE20). You first need to view conflicts identified, 
and then select to resolve them. 


To resolve an automatically resolvable conflict: 
1. From the products explorer, select the product for which you want to view identified conflicts. 
2. Select the Conflicts View for the product. 


3. Select the category containing the automatically resolvable conflict from the Conflict Information list. 


testlabsql2k (HowePublisher2004) - sa - InstallShield ConflictSolver DAR) 


h” PackageForTheWeb 4 a] 


5 E Groups aN Conflict view 


{£ Accounting I B 
w InstallShield Software Corporation _F fee eee Product Properties v 


@ Marketing Conflict Details 
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-fR PackageForTheWeb 4 (v4.0.0) #2) The package code '{SE6C9285-00E1-4547-AB97-C2577EDASF71}' is the same in 1 other package(s). 
S Conflicts oH aceis 


Wf Extended Attributes E- The product code '{C9COAF10-7B04-449E-9FAC-5436D2E238EC}' is the same in 1 other package(s). 


INI File Changes 
Merge Modules 
a Registry 
E Shortcuts 


f Tables 


{ Research 


E] D The upgrade code '{85447049-4809-495E-BC94-7DF40EBBSE82}' is the same in 1 other package(s). 


I . 
fhe chee S acezo 


Products 


4. Expand the ACE containing conflicts that can be resolved. The icon next to the conflict indicates its 
status: 


@- Resolvable 
© Unresolvable 


Q- Resolved 


5. Select the conflict you want to resolve and click Resolve. Alternatively, click Resolve All to resolve all 
resolvable conflicts for the selected conflict category. 
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6. For CARDs that can be resolved in multiple ways, and if the Maximize user flexibility in selecting 
resolutions option is selected on the Resolution Tab of the Options dialog, the CARD Resolution Options 
Dialog appears, prompting you to make a selection to determine how conflict resolution will proceed. 


CARDO6 - Resolution Options 


CARDO will update the 'DRYConflict' component 'KeyPath' field with your 
selection. 


Files 


FRAMEBLUF.DRY | 


Make a selection and click OK to continue. 


7. Ifthe Preview and approve all resolutions option on the Resolution Tab of the Options Dialog is 
selected, the Resolution Details Dialog will appear, listing the proposed CARD resolutions that will be 
made to the package. 


Resolution Details 


The CARD resolutions will execute the Following changes to the package. Please approve the 
changes before the resolution process can be completed. 


CARD Details 


Information Details 
SScarv19 Update the 'ProductCode' property with a newly generated GUID, 
SScarvz0 Update the 'UpgradeCode' property with a newly generated GUID, 


[C Don't show this dialog again 


Select the CARD resolutions that you want to resolve, and click Approve to execute them. 


If the Preview and approve all resolutions option is not selected, the Resolution Details Dialog will not 
appear, and all selected conflict resolutions will be executed. 


Resolutions are made to either the original Windows Installer package or in a transform (if the Perform resolutions 
against a transform file option is selected on the Resolution tab of the Options dialog). 
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Manually Resolving Conflicts 


Due to their complexity, some conflicts require manual resolution using Tuner or DevStudio. 


Por information on manual solutions, consult the Application Conflict Evaluators (ACEs) topic or individual ACE 
topics. These topics can provide valuable information regarding what is causing the conflict, so you can use Tuner or 
DevStudio to solve it. 


Once you have resolved detected conflicts manually, you can reimport the package into ConflictSolver. 


Resolving Conflicts Directly in Windows Installer Packages 


ConflictSolver provides two methods for implementing conflict resolutions: directly in the Windows Installer package, 
ot through the use of a transform. 


To configure ConflictSolver to resolve conflicts directly in the original Windows Installer 
package: 


1. Select Options from the Tools menu to display the Options Dialog. 


2. On the Resolution Tab, clear the Perform resolutions against a transform file check box. 


Options 


Extended Attributes | ____ Duplicate Package 


General Import Validate | Resolution | Conflicts 


Initial Resolution Location 


Resolution Options 
Preview and approve all resolutions 
Maximize user flexibility in selecting resolutions 


3. Click OK to close the Options Dialog. 
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With this setting disabled, all conflict resolutions are by default performed directly on the base Windows Installer 
package. In either case, you can override this setting on a package-by-package basis by clicking Edit in the Summary 
section of the Conflicts View and editing the resolution options on the Resolution Options Dialog. 


Using Transforms for Conflict Resolution 


ConflictSolver provides two methods for implementing conflict resolutions: directly in the Windows Installer package, 
ot through the use of a transform. 


To configure ConflictSolver to use transforms for conflict resolutions: 
1. Select Options from the Tools menu to display the Options Dialog. 


2. On the Resolution Tab, select the Perform resolutions against a transform file check box. 


Options 


Extended Attributes || Duplicate Package 
General | Import | Validate | Resolution Conflicts 


Initial Resolution Location 


Resolution Options 
Preview and approve all resolutions 
Maximize user flexibility in selecting resolutions 


3. Click OK to close the Options Dialog. 


With this setting enabled, all resolutions will by default be placed within a transform, rather than being made in the 
Windows Installer package. In either case, you can override this setting on a package-by-package basis by clicking Edit 
in the Summary section of the Conflicts View and editing the resolution options on the Resolution Options Dialog. 
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Reimporting Packages after Successful Conflict Resolution 


Following resolution of conflicts, you should reimport the package into ConflictSolver. If you have performed 
automatic resolutions, you can do so by clicking Reimport in the Conflicts View for that package (or use F7 to 
reimport). The package (and the resolution transform if used) are reimported into ConflictSolver. 


However, if you have performed manual resolutions to the package via a transform, you need to delete the package 
from ConflictSolver and then reimport the package with its externally created transform. 


After reimporting a package, it is generally a good practice to run conflict identification again. 
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Generating Reports 


ConflictSolver includes several built-in reports to provide information on packages and conflicts identified, all 
accessible from the Reports menu. The included reports are: 


Report Description 


Conflicts Provides a report of all conflicts found during the most recent Conflict Wizard execution, or 
the most recent Import (if conflict identification was performed). 


File Search Provides a way to search for a file within the ConflictSolver, or in a specific package. 


Files Provides a comprehensive listing of all files in ConflictSolver, sorted on a per package and 
per component basis. This report is also available on a per-product basis by right-clicking 
on a product in the products explorer. 


Registry Provides a comprehensive listing of all registry entries in ConflictSolver, sorted on a per 
package and per component basis. This report is also available on a per-product basis by 
rightclicking on a product in the products explorer. 


Registry Search Provides a way to search for a registry entry within ConflictSolver, or in a specific 
package. 


Custom Reports 


ConflictSolver supports custom reports; however, the responsibility of creating them is up to individual users. Reports 
must be in Crystal Reports format (.rpt) and placed in the folder specified in the General tab of the Options dialog, 
available from the Tools menu. These reports appear under the Reports menu. 


Generating Conflict Reports 
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To generate a conflict report 
1. Select the appropriate report from the Reports menu in ConflictSolver. 
OR 


2. Right-click on a product in the products explorer and select the report you want to run from the context 
menu. 
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Creating Custom Reports 


The following procedure explains how to create a custom report for ConflictSolver using AdminStudio and Crystal 
Reports 8. The resulting report allows you to search ConflictSolver and generate reports based on the presence of a 
specified INI file. You must have Crystal Reports 8 installed for this procedure. This procedure contains the following 
steps: 


Q 
r 


—i 
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Creating an ODBC File DSN 
Creating the Base Report 
Configuring Basic Settings 
Creating Page Column Headings 
Adding Database Fields 

Adding Parameters 

Creating Conditions for Filtering 
Modifying the Footer 


rr Se eS PU 


Using the Report in ConflictSolver 


10. Summary 
Creating an ODBC File DSN 
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To create an ODBC File DSN: 


1. From the Windows Start menu, point to Programs, then Administrative Tools, then click on Data Sources 
(ODBC). This starts the Microsoft ODBC Data Source Administrator. 


Click on the File DSN tab and click Add. 

Select Microsoft Access Driver (*.mdb) from the drivers list and click Next. 

Name the data source as CSIniFileSearch and click Next. 

Click Finish. 

Click Select and browse and select the ConflictSolver sample Access Application Catalog. 


Click OK, and then OK again. 


a oe Ce oN 
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Creating the Base Report 
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To create the base report: 


9 NFM Se SOP 


10. 
11. 


Start Crystal Reports. 

Select Blank Report either from the Welcome dialog or from the New Report dialog box. 
Expand CSlniFileSearch.dsn under ODBC from the Data Explorer dialog box. 

Select IniFile from the list of tables under CSIniFileSearch.dsn and click Add. 

Select Component from the list of tables under CSIniFileSearch.dsn and click Add. 
Select Package from the list of tables under CSIniFileSearch.dsn and click Add. 

Click Close. 


Crystal Reports will use its smart linking feature to link the selected tables. Delete the link between IniFile 
and Package. 


Create a link between Component and Package table by dragging the PackageCode field from the 
Component table and dropping into the PackageCode field in the Package table. 


Click OK on the Visual Linking Expert dialog box. 


From the Field Explorer dialog, click Close. You should now see a blank report in the design mode with 
header, details and footer sections. 
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Configuring Basic Settings 


To configure basic settings: 


From the File menu, select Printer Setup and change the orientation from Portrait to Landscape. 


If you are building a report from the SQL Server database, the tables added may contains the 
[database_name].[user_name] in front of them. Make sure you get rid of them and just keep the table name, 
so that your report works even if you connect to other Application Catalogs. To do this, click on Database | 
Set Location... and click on each table and make sure that it contains just the table names by looking at the 
Table text box name under the Location frame. 


From the File menu, select Summary Info. 

Type "IniFile Search Report" in the Title text box, and click OK. 

From the Insert menu, select Special Field. 

Scroll down and select Report Title from the list and click on the Insert to Report toolbar button. 


Click Close. 


Creating Page Column Headings 


To create page column headings: 


Select Text Object from the Insert menu and drop the mouse on the left side inside the Page Header 
section. 


Type "Product" in the text object. 


Click on the above text object, press Ctrl+C to copy it, press Ctrl+V and drop the mouse adjacent to the 
first text object. Change the text from Product to Component. 


Repeat the above step and add the columns named File Name, Path, INI Section, INI Key, INI Key 
Value, and Action. 


If desired, you can rightclick on the text objects and select Change Font to update the font. 
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Adding Database Fields 
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To add database fields: 


Select Database Fields from the Insert menu. 


Expand the Package table node, press Enter on the ProductName field, and drop the mouse in the 
Details section under the Product page heading. 


Expand the Component table, select Component field, press Enter, and drop the mouse in the Details 
section under the Component page heading. 


Select the IniFile table and drop FileName, FullPath, IniSection, IniKey, IniValue, and IniAction fields. 
Select all the fields in the detail section 

Right-click on the fields and select Format Object. 

Check the Can Grow box. 


Save the report file under the following folder: C:\Program 
Files\InstallShield\AdminStudio\3.5\ConflictSolver\Reports\Standard. 


Adding Parameters 


Standard ConflictSolver reports require at least two parameters to be defined in the report file. 


To add parameters: 


From the Insert menu, select Parameter Field. 

Click on New from the toolbar or press Ctrl+N. 

Type the parameter name as ProductName and leave the type to default value of String. 
Repeat this step and add one more parameter named ProductVersion of type String. 
Click Close. 


ConflictSolver automatically passes values for these parameters. In ConflictSolver when the report is 
select from the main menu item, these parameters are passed as *; and when the report is selected by 
right clicking on the package, ConflictSolver passes the ProductName and ProductVersion for the 
selected package. 


For this report, a prompt is needed so you can enter an INI file name, and based on that, show the 
filtered record. This requires another parameter. 
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To add the third parameter: 
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From the Insert menu, select Parameter Field. 
Type the parameter name as INIFileName. 
Set the type to String. 


Type "Enter the INI File Name. Use * as a wildcard character." in the Prompting Text box. 
Click OK. 


Click Close to dismiss the Field Explorer dialog. 


Creating Conditions for Filtering 
hea 
O 


To create the condition to filter the records based on the input parameters 
(ProductName, ProductVersion, and INIFileName): 


2. 


3. 


From the Report menu, point to Edit Selection Formula and select Record. 


Type the following text in the Filter Criteria text box: 


{IniFile.FileName} like {2INIFileName}andif {2ProductName} = '*' then TRUEelse 
{Package.ProductName} = {?ProductName}andif {@ProductVersion} = '*' then TRUEelse 
{Package.ProductVersion} = {?ProductVersion} 


Crystal Reports uses the above selection formula while sending the SQL query to the backend database 
server. The above formula makes the WHERE clause in the SELECT database query, which is internally 
sent by Crystal Reports while viewing the report. The above formula filters the Application Catalog 
records based on the IniFile.FileName, and if ProductName/ProductVersion are passed they are used, 
else only the IniFile.FileName is used in the selection criteria. 


Click Save from the toolbar. 
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Modifying the Footer 


(g)— 

To add the date/time and page number to the report footer: 

1. From the Insert menu, select Special Field. 

2. Select Page N of M and drop it on the report within the Report Footer section. 
3. Repeat for Print Date and Print Time. 
4 


. Save the report. 


5. Close Crystal Reports and start ConflictSolver. 


Using the Report in ConflictSolver 


The Reports menu item in ConflictSolver is dynamically generated based on the .rpt report files present in the Reports 
folder. Start ConflictSolver, open the sample Application Catalog, click on Options from the Tools menu, and ensure 
that the above report is saved in the Reports folder as specified in the General tab. 


If you select INIFile Search Report from the Reports menu, you can access the report you just created. 


2 _ 


To use the report: 
1. From the Reports menu, point to Standard and then select INIFile Search Report. 


2. Type system. ini in the text box and click OK. A report is generated. You can use * as the wildcard 
character while typing the INI file name. Open some other Application Catalog for ConflictSolver, run 
the report, type the name of the file and verify the results by looking at the report. You can also right- 
click on the package in ConflictSolver and generate the IniFile Search report only for the selected 
package. 


Summary 


ConflictSolver stores the imported packages in a relational database. Crystal Reports can be used to quickly query this 
database and generate reports. In this step-by-step guide you created a sample report that searches the IniFile table in 
ConflictSolver based on the FileName provided as a parameter. 
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Application Consistency Evaluators (ACEs) 


Application Conflict Evaluators (ACEs) are the rules that allow ConflictSolver to identify conflicts between Windows 


Installer-based setups, and between Windows Installer-based setups and operating system images (OS Snapshots). 


ConflictSolver can automatically solve some of the conflicts spelled out in these rules. When an automatic remedy is 


available, the associated rule used to fix the conflict is spelled out in a Conflict Application Resolution Definition 


(CARD). 


The following links, grouped by conflict type, explain each ACE rule. 


Conflict Type 


Associated Rules 


Component ACEO2, ACEO4, ACEO5, ACEO6, ACEO9 
Files ACEO3, ACEO7, ACEO8, ACE12, ACE23 
Registry ACE10, ACE24 

Shortcuts ACE13 

INI Files ACE14, ACE21, ACE22 

ODBC Resources ACE15 

NT Services ACE16 

File Extensions ACE17 


Product Codes 


ACE18, ACE19, ACE20 


User-Defined ACEs 


In addition to these ACEs included with ConflictSolver, you can also create three types of user-defined ACHs to use 


when detecting conflicts: Source Only, Source and Target, and DLL-Based. See User-Defined ACEs for more 


information. 
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The following list provides links to each individual ACE. These ACEs are used to identify potential conflicts between 


installation packages. 
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ACE Rule Conflict Type Brief Description of ACE 

ACEO2 Component Checks to see if components in different packages that have matching 
Componentlds also have identical destination paths. 

ACEO3 Files Checks to see if components in different packages that have matching 
Componentlds also contain the same files. 

ACEO4 Component Checks to see if components that have NULL KeyPath values are valid by 
checking for an entry for the component in the CreateFolder table. 

ACEO5 Component Checks for the existence of more than one executable (EXE, DLL, OCX, 
HLP, CHM, TLB, SYS, DRV) per component in a Windows Installer 
package. 

ACE06 Component Checks whether the executable module (EXE, DLL, OCX, HLP, CHM, TLB, 
SYS, or DRV) within the component is the key file. 

ACEO7 Files Checks for the existence of the same file in components with different 
Componentlds. 

ACEO8 Files Identifies components with identical Componentlds, and checks those 
components to see if the versions of the files in each component match. 

ACEO9 Component Checks to see if merge modules with identical Componentlds are 
identical. 

ACE10 Registry Checks for the existence of identical Root/Key/Name registry 
combinations in components with different Componentlds. 

ACE12 Files Checks for components that contain files that can be replaced by one of 
the merge modules that you have imported into the Application Catalog 
database. (Before running ACE12, you should import all merge modules 
you are likely to use at your organization.) 

ACE13 Shortcuts Checks for the existence of the same shortcut within different packages in 
components with different Componentlds. 

ACE14 INI Files Checks for the existence of components with different Componentlds that 
modify the same INI file entry, such as the [File 
Name/Section/Key/Value] entry. 

ACE15 ODBC Resources Checks for the existence of identical ODBC entries in components with 
different Componentlds. 
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ACE Rule 


Conflict Type 


Brief Description of ACE 


ACE16 


NT Services 


Checks for the existence of identical NT Services in components with 
different Componentlds. 


ACE17 


File Extensions 


Checks for identical file Extension/Verb combinations in components with 
different Componentids. 


ACE18 


Product Codes 


Checks the Package Code to see if it is unique. 


ACE19 


Product Codes 


Checks the Product Code to see if it is unique. 


ACE20 


Product Codes 


Checks the Upgrade Code to see if it is unique. 


ACE21 


INI Files 


Checks entries in the IniFile table to see if they conflict with similar entries 
in the File table. The IniFile and File tables can change the same physical 
file. As a result, this ACE identifies these duplicate file changes so that 
they can be evaluated. 


ACE22 


INI Files 


Checks file name/target directory pairs in the File table to see if they 
conflict with similar entries in the IniFile table. The IniFile and File tables 
can change the same physical file. As a result, this ACE identities these 
duplicate file changes so that they can be evaluated. 


ACE23 


Files 


Identifies file duplication between source and target packages. ACE23 
checks to see if files with the same name and destination directory have 
the same size, version, and language when comparing a source package 
against a target package. If a file with the same name and destination 
directory is found in both the source and target packages, but the file has 
a different size, version, or language, ACE23 fails. 


ACE24 


Registry 


Checks to see if registry entries with the same registry hive, key, and value 
name have the same data type and value. If a registry entry with the same 
registry hive, key, and value name in a package is found in both the 
source and target package, but the registry entry has a different data type 
or value, ACE24 fails. 
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ACEO2 (Components) 


ACE02 checks to see if components in different packages that have matching Componentlds also have identical 
destination paths. The ACE02 Error String is displayed in the following format: 


The destination [PATH1] for the component [COMPONENT1] in the package [PACKAGE1] conflicts 
with the destination for the component [COMPONENT1] in the package [PACKAGE2]. The correct 
destination should be [PATH2]. 


Summary 

Conflict Type: Component 

Description: Checks to see if components in different packages that have matching Componentlds also 
have identical destination paths. 

Result: If components with the same Componentld have different destination paths, ACEO2 fails. 

Resolution Type: Automatic (CARDO2) 

Resolution: The destination path of the component in the Source package is automatically set to match 
that of the component in the Target package. 


ACEO3 (Files) 


ACE02 checks to see if components in different packages that have matching Componentlds also contain the same 
files. The ACE03 Error String is displayed in the following format: 


The file(s) [FILENAME] in the component [COMPONENT1] in the package [PACKAGE1] are either 
new to or missing from the component [COMPONENT1] in the package [PACKAGE2]. 


Summary 

Conflict Type: File 

Description: Checks to see if components in different packages that have matching Componentlds also 
contain the same files. 

Result: If components with the same Componentld do not contain the same files (either files are 
missing or they are different versions}, ACEO2 fails. 

Resolution Type: Manual 

Resolution: Use DevStudio to create a Windows Installer Transform (.mst) file for the Source package 
MSI so that the component in the Source package contains the same files as the 
component in the Target package. 
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Cause 


The Componentlds for components in two different MSI packages are identical but either files are missing or 
different in those components. 


This conflict requires a manual resolution. Follow these steps: 


g` \ 
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To resolve this conflict: 
1. Open the MSI package in InstallShield DevStudio. 


2. Add or modify the components as necessary so that the file(s) is present in both components and the 
versions match in both MSI packages. To accomplish this: 


a. Open the Components View and find the component that needs to be modified. 


b. Expand the list under the component and select Files. A list of the files included with that component 
is displayed. 


c. To delete a file that is not present in the other component, select the file, right-click and choose 
Delete from the menu. 


d. If you need to add a new file to match the other component, right click anywhere in the Files list, 
choose Add from the menu, and add the correct file. 


3. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


4. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACEO3 again. 
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ACEO4 (Components) 


ACE04 checks to see if components that have NULL KeyPath values are valid by checking for an entry for the 
component in the CreateFolder table. The ACE04 Error String is displayed in the following format: 


The component [COMPONENT1] in the package [PACKAGE1] does not have a key file. 
Additionally, the directory/component pair is not listed in the CreateFolder table. 


Summary 

Conflict Type: Component 

Description: Checks to see if components that have NULL KeyPath values are valid by checking for an 
entry for the component in the CreateFolder table. 

Result: If a component does not have a key file, and if the directory/component pair is not listed 
in the CreateFolder table, ACEOA fails. 

Resolution Type: Automatic (CARDO) 

Resolution: A CreateFolder entry is created for the component. 


ACEO5 (Components) 


ACEO05 checks for the existence of more than one executable (EXE, DLL, OCX, HLP, CHM, TLB, SYS, DRV) per 
component in a Windows Installer package. The ACE05 Error String is displayed in the following format: 


The component [COMPONENT1] in the package [PACKAGE1] has more than one executable module 
C@ Eni, “oC, “aGlry, “.22, “alu, °.@8%, ~.SS, Or Pll). Wie Tile 
[EXECUTABLE_MODULE_FILENAME] must be included as a separate component. 


Summary 

Conflict Type: Component 

Description: Checks for the existence of more than one executable (EXE, DLL, OCX, HLP, CHM, TLB, 
SYS, DRV) per component in a Windows Installer package. 

Result: If more than one executable exists in a component, ACEOS fails. 

Resolution Type: Automatic (CARDOS5) 

Resolution: Modifies the component so that only one EXE or DLL exists, and it adds new components 
for remaining EXE, DLL, OCX, HLP, CHM, TLB, SYS, and DRY files. 
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ACE06 checks whether the executable module (EXE, DLL, OCX, HLP, CHM, TLB, SYS, or DRV) within the 
component is the key file. The ACE06 Error String is displayed in the following format: 


The component [COMPONENTL] in the package [PACKAGE1] does not have an executable module 
(@echm, *-.dill), *.drv, *-exe, *-hilp, *-ocx, *.sys, of *-tlb)) as the key fille. The current 
key file [NON-EXECUTABLE_FILENAME] can be replaced with [EXECUTABLE_MODULE_FILENAME]. 


Summary 
Conflict Type: Component 
Description: Checks whether the executable module (EXE, DLL, OCX, HLP, CHM, TLB, SYS, or DRY) 
within the component is the key file. 
Result: If the executable module is not the key file, ACEO6 fails. 


Resolution Type: 


Automatic (CARDO6) 


Resolution: 


The executable module is automatically made the key file. 


ACEO7 (Files) 


ACEO7 checks for the existence of the same file in components with different Componentlds. The ACE07 Error 
String is displayed in the following format: 


The file [EXECUTABLE_MODULE_FILENAME] is identical in both the component [COMPONENT1] in 
the package [PACKAGE1] and the component [COMPONENT1] in the package [PACKAGE2], but the 
components have different GUIDs. 


Summary 
Conflict Type: File 
Description: Checks for the existence of the same file in components with different Componenilds. 
Result: If the same file exists in components with different Componentlds, ACEO7 fails. 


Resolution Type: 


Automatic (CARDO7) 


Resolution: 


The Source package Componentld is changed to match the Target package Component Id. 
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ACEOS (Files) 


ACEO08 identifies components with identical Componentlds, and checks those components to see if the versions of 


the files in each component match. The ACE08 Error String is displayed in the following format: 


The file version [VERSION_NUMBER1] of file [EXECUTABLE_FILENAME] in the component 
[COMPONENT1] in the package [PACKAGE1] conflicts with the same file in the component 


[COMPONENT1] in the package [PACKAGE2]. The correct version should be [VERSION_NUMBER2]. 


ACEO8 is a warning, not an error. 


Summary 
Conflict Type: File 
Description: Identifies components with identical Componentids, and checks those components to see if 
the versions of the files in each component match. 
Result: If components with identical Componentlds contain files with different versions, ACEO8 
fails. 
Resolution Type: Manual 
Resolution: Change the file versions to match those of the Target component, or change the file 
versions in the Source component. 
Cause 


Two components with identical Componentlds in different packages have the same file with different versions. 


This conflict requires a manual resolution. Follow these steps: 
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1. Open the MSI package in InstallShield DevStudio. 


2. Once the project is open, there are two options that can be used to resolve the issue: 


Option #1: Change the Component Code. To accomplish this: 


a. Open the Components View and select the component that needs to be modified. 


InstallShield Software Corporation © 2004 


784 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


b. In the Component's Property grid, change the value in the Component Code field. 


Option #2: Replace the files so that the versions match in both MSI packages. To 
accomplish this: 


a. Open the Components View and find the component that needs to be modified. 


b. Expand the listing under the component, and select Files. The list of files included with that 
component is displayed. 


c. To delete a file with the wrong version, select the file, right-click and choose Delete from the menu. 


d. To add the correct version of a file, right click anywhere in the Files list, choose Add from the menu, 


and add the new file with the correct version. 
3. Select Save As on the File menu and save the changes as a Windows Installer Transform (.mst) file. 


4. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACEO8 again. 


ACEO9S (Components) 


ACE09 checks to see if merge modules with identical Componentlds are identical. The ACE09 Error String is 
displayed in the following format: 


The version [VERSION_NUMBER1] of the merge module [MERGE_MODULE_NAME] in the package 
[PACKAGE1] conflicts with the same merge module in the package [PACKAGE2]. The correct 
version should be [VERSION_NUMBER2]. 


ACEO9 is a warning, not an error. 


Summary 
Conflict Type: Component 
Description: Checks to see if merge modules with identical Componentlds are identical. 
Result: If merge modules with identical Componentlds are different, a warning is generated. 
Resolution Type: Manual 
Resolution: Obtain the latest version of the merge module and rebuild the MSI. 
Cause 


Two merge modules with identical Componentlds but different versions are found in different packages. 
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This conflict requires a manual resolution. Follow these steps: 
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1. Obtain the latest version of the merge module displayed in the ACE message. The merge module may 
be available for download at the vendor's web site. 


P 


Open the MSI package in InstallShield DevStudio. 


» 


Place the new merge module in one of the Merge Module Locations that are specified on the Tools | 
Options | Merge Modules tab. This allows the merge module to be displayed in the Redistributables 
view of the InstallShield DevStudio Environment. 


4. Navigate to the Redistributables View in the DevStudio project. Deselect the old merge module causing 
the conflict and select the new merge module in its place. 


5. Select Save As on the File menu and save the changes as a Windows Installer Transform (.mst) file. 


6. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACEO9 again. 


ACE10 (Registry) 


ACE10 checks for the existence of identical Root/Key/Name registry combinations in components with different 
Componentlds. The ACE10 Error String is displayed in the following format: 


The registry entry [REGISTRY_ENTRY] [REGISTRY_KEY] in the component [COMPONENT1] in the 
package [PACKAGE1] conflicts with the same registry entry in the component [COMPONENT1] in 
the package [PACKAGE2]. 


f K ) 
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ACE10 is a warning, not an error. 


Summary 
Conflict Type: Registry 
Description: Checks for the existence of identical Root/Key/Name registry combinations in components 
with different Componentlds. 
Result: If the same Root/Key/Name registry combination is in more than one component, a 
warning is generated. 
Resolution Type: Manual 
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Resolution: Change the Componentld of the Source component to match that of the Target component. 


The same Root/Key/Name registry combination is found in more than one component. 


When Might You Ignore a ConflictSolver ACE10 Error? 


ACE10 uses data from the MSI Registry table to check for identical registry Root/Key/Name combinations in 
different components. However, there may be situations in which ACE10 will report an error unnecessarily. MSI 
supports a grammar for the Registry table in which if the Value field is preceded or terminated by the sequence tilde 
‘[~]', then the registry value will be appended or prepended, respectively, to the existing registry Value. This sort of 
operation may be perfectly acceptable if the applications in question are modifying a common registry key in a manner 
consistent with its purpose. 


You will need to decide individually if an ACE10 error is valid, but please consider checking the Registry Value field, 
as its contents may prove useful in helping you decide. 


e 
Resolution 
This conflict requires a manual resolution. Follow these steps: 


1e \ 
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To resolve this conflict: 


1. Open the MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View and find the component that needs to be 
modified by referring to the component name displayed in the error message. 


3. In the Component's Property grid, change the value in the Component Code field to match the 
Component Code (Componentld) of the component in the other project. 


If it is unclear what the value should be changed to, follow these steps: 


a. Open up the package that will not be modified in Direct Edit mode by selecting Direct Editor under 
Additional Tools. A list of the package tables is displayed. 


b. Select the Component table and search for the Component Name displayed in the conflict. 


c. Once the entry is found, take note of the value displayed in the Componentld column. This is the 
Component Code that should be used for the component in the other package. 


4. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACE10 again. 
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ACE12 (Files) 


ACE12 checks for components that contain files that can be replaced by one of the merge modules that you have 
imported into the Application Catalog database. (Before running ACE12, you should import all merge modules you 
are likely to use at your organization.) The ACE12 Error String is displayed in the following format: 


The file [FILENAME] in the component [COMPONENT1] in the package [PACKAGE1] should be 
replaced with the merge module [MERGE_MODULE_NAME]. 


Summary 
Conflict Type: File 
Description: Checks for components that contain files that can be replaced by one of the merge 
modules that you have imported into the Application Catalog database. (Before running 
ACE12, you should import all merge modules you are likely to use at your organization.) 
Result: If components contain files that can be replaced by merge modules, ACE12 fails. 
Resolution Type: Manual 
Resolution: Rebuild the package using the merge module rather than the duplicate files. 
Cause 


A component within one package contains a file that is found in a merge module of another package. Using merge 
modules is always preferable as a way to install files in a consistent fashion. 


This conflict requires a manual resolution. Follow these steps: 


A 
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To resolve this conflict: 
1. Open the MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View, and find the component that needs to be 
modified by referring to the component name displayed in the error message. 


3. Expand the list under the component and select Files. A list of the files included with that component is 
displayed. 


4. Select the file that was displayed in the error message, right-click, and select Delete from the menu. 


5. Take note of the feature that the component is associated with and then navigate to the Redistributables 
View. 
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6. In the Redistributables View, select the appropriate merge module. 


7. After selecting the merge module, move to the Conditional Installation View on the right side and select 
the feature that was mentioned earlier. 


8. Rebuild the package. 


9. Open ConflictSolver and reimport this package into your Application Catalog, and then use the 
Conflict Wizard to check it against ACE12 again. 


ACE13 (Shortcuts) 


ACE13 checks for the existence of the same shortcut within different packages in components with different 
Componentlds. The ACE13 Error String is displayed in the following format: 


The shortcut [SHORTCUT_NAME] in the component [COMPONENT1] in the package [PACKAGE1] 
conflicts with the same shortcut in the component [COMPONENT2] in the package [PACKAGE2] . 


Summary 
Conflict Type: Shortcut 
Description: Checks for the existence of the same shortcut within different packages in components with 
different Componentids. 
Result: If the same shortcut exists in more than one component, ACE13 fails. 
Resolution Type: Manual 
Resolution: Change the Componentld of the Source component to match the Component Id of the 
Target component. 
Cause 


The same shortcut is found in components with different ComponentIDs in two different packages. 


This conflict requires a manual resolution. Follow these steps: 
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To resolve this conflict: 
1. Open the MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View, and find the component that needs to be 
modified by referring to the component name displayed in the error message. 
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3. In the Component's Property grid, change the value in the Component Code field to match the 
Componentld of the component in the other project. 


If it is unclear what the value should be changed to, follow these steps: 


a. Open up the package that will not be modified in Direct Edit mode by selecting Open on the File 
menu, and then selecting Direct Editor under Additional Tools. A list of the package tables is 
displayed. 


b. Select the Component table and search for the Component Name displayed in the conflict. 


c. Once the entry is found, take note of the value displayed under the Componentld column. This is 
the Component Code that should be used for the component in the other package. 


4. Select Save As on the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACE13 again. 


ACE14 (INI Files) 


ACE14 checks for the existence of components with different Componentlds that modify the same INI file entry, 
such as the [File Name/Section/Key/Value] entry. If this condition is found, ACE14 returns the following Warning: 


The INI file entry [INI_FILE_ENTRY] in the file [INI_FILE_NAME] in the component 
[COMPONENT1] in the package [PACKAGE1] conflicts with the same INI file entry in the 
component [COMPONENT1] in the package [PACKAGE2]. 


Summary 

Conflict Type: INI File 

Description: Checks for the existence of components with different Componentlds that modify the same 

INI file entry, such as [File Name/Section/Key/Value]. 

Result: If the same INI file entry is modified by different components, ACE14 fails. 

Resolution Type: Manual using the instructions under Resolution below 

Resolution: Change the Componentld of the Source component to match that of the Target component. 
Cause 


The same INI file is found in components with different Componentlds in two different packages. 


This conflict requires a manual resolution. Follow these steps: 
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To resolve this conflict: 
1. Open the MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View, and find the component that needs to be 
modified by referring to the component name displayed in the Warning. 


3. In the Component's Property grid, change the value in the Component Code field to match the 
Component Code (Componentld) of the component in the other project. 


If it is unclear what the value should be changed to, follow these steps: 


a. Open up the package that will not be modified in Direct Edit mode by selecting Open on the File 
menu, and then selecting Direct Editor under Additional Tools. A list of the package tables is 
displayed. 


b. Select the Component table and search for the Component Name displayed in the conflict. 


c. Once the entry is found, take note of the value displayed under the Componentld column. This is 
the Component Code that should be used for the component in the other package. 


4. Select Save As on the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACE14 again. 


ACE15 (ODBC Resources) 


ACE15 checks for the existence of identical ODBC entries in components with different Componentlds. The ACE15 
Error String is displayed in the following format: 


The ODBC entry [ODBC_ENTRY] in the component [COMPONENT1] in the package [PACKAGE1] 
conflicts with the same ODBC entry in the component [COMPONENT1] in the package 
[PACKAGE2]. 


Summary 
Conflict Type: ODBC Resources 
Description: Checks for the existence of identical ODBC entries in components with different 
Componentlds. 
Result: If identical ODBC entries exist in components with different Componentlds, ACE15 fails. 
Resolution Type: Automatic (CARD 15) 
Resolution: ConflictSolver changes the Source Componentld to match that of the Target Componentld. 
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ACE16 (NT Services) 


ACE16 checks for the existence of identical NT Services in components with different Componentlds. The ACE16 
Error String is displayed in the following format: 


The NT service [SERVICE1] in the component [COMPONENT1] in the package [PACKAGE1] 
conflicts with the same NT Service in the component [COMPONENT1] in the package 
[PACKAGE2]. 


Summary 
Conflict Type: NT Services 
Description: Checks for the existence of identical NT Services in components with different 
Componenitlds. 
Result: If identical NT Services exist within different components, ACE16 fails. 
Resolution Type: Manual 
Resolution: Change the Componentld of the Source component to match the Componentld of the 
Target component. 
Cause 


The same NT Service is found in components with different ComponentIDs in two different packages. 


This conflict requires a manual resolution. Follow these steps: 


fN 
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To resolve this conflict: 
1. Open the package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View, and find the component that needs to be 
modified by referring to the component name displayed in the error message. 


3. In the Component's Property grid, change the value in the Component Code field to match the 
Component Code (Componentld) of the component in the other project. 


If it is unclear what the Component Code should be changed to, follow these steps: 


a. Open up the package that will not be modified in Direct Edit mode by selecting Open on the File 
menu, and then selecting Direct Editor under Additional Tools. A list of the package tables is 
displayed. 
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b. Select the Component table and search for the Component Name displayed in the conflict. 


c. Once the entry is found, take note of the value displayed in the Componentld column. This is the 
Component Code that should be used for the component in the other package. 


4. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACE16 again. 


ACE17 (File Extensions) 


ACE17 checks for identical file Extension/Verb combinations in components with different Componentlds. The 
ACE17 Error String is displayed in the following format: 


The verb [VERB_NAME] in extension [EXTENSION_NAME] in the component [COMPONENT1] in the 
package [PACKAGE1] conflicts with the same verb & extension in the component [COMPONENTL] 
in the package [PACKAGE2]. 


Summary 
Conflict Type: File Extension 
Description: Checks for identical file Extension/Verb combinations in components with different 
Componentlds. 
Result: If identical file Extension/Verb combinations exist in components with different 
Componentlds, ACE17 fails. 
Resolution Type: Manual 
Resolution: Change the Componentld of the Source component to match the Componentld of the 
Target component. 
Cause 


The same Extension/Verb combination is found in components with different Componentlds in two different 
packages. 
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This conflict requires a manual resolution. Follow these steps: 


To resolve this conflict: 
1. Open the transform file or MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Components View, and find the component that needs to be 
modified by referring to the component name displayed in the error message. 


3. In the Component's Property grid, change the value in the Component Code field to match the 
Component Code (Componentld) of the component in the other project. 


If it is unclear what the Component Code should be changed to, follow these steps: 


a. Open up the package that will not be modified in Direct Edit mode by selecting Open on the File 
menu, and then selecting Direct Editor under Additional Tools. A list of the package tables is 
displayed. 


b. Select the Component table and search for the Component Name displayed in the conflict. 


c. Once the entry is found, take note of the value displayed in the Componentld column. This is the 
Component Code that should be used for the component in the other package. 


4. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its newly created transform file into your 
Application Catalog, and then use the Conflict Wizard to check it against ACE17 again. 
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ACE18 (Product Properties) 


ACE18 checks the Package Code to see if it is unique. The ACE18 Error String is displayed in the following format: 


The package code [PACKAGE_CODE] in the package [PACKAGE1] is the same as the package code 
in the package [PACKAGE2]. 


Summary 
Conflict Type: Product Properties 
Description: Checks the Package Code to see if it is unique. 
Result: If the Package Code is identical to any other Package Code in ConflictSolver, ACE18 fails. 
Resolution Type: Automatic (CARD 18) 
Resolution: A new, unique Package Code is automatically generated to replace the duplicate code. 


Kona 


‘men 
( A) — 


\| 
N 


ACE18 can only be resolved automatically when applying changes directly to the original Windows Installer package. 
lt cannot be used when resolving using a transform. 


ACE19 (Product Properties) 


ACE19 checks the Product Code to see if it is unique. The ACE19 Error String is displayed in the following format: 


The product code [PRODUCT_CODE] in the package [PACKAGE1] is the same as the product code 
in the package [PACKAGE2]. 


Summary 
Conflict Type: Product Properties 
Description: Checks the Product Code to see if it is unique. 
Result: If the Product Code is identical to any other Product Code in ConflictSolver, ACE19 fails. 
Resolution Type: Automatic (CARD 19) 
Resolution: A new, unique Product Code is automatically generated to replace the duplicate code. 
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The upgrade code [UPGRADE_CODE] in the package [PACKAGE1] is the same as the upgrade code 
in the package [PACKAGE2]. 


Summary 
Conflict Type: Product Properties 
Description: Checks the Upgrade Code to see if it is unique. 
Result: If the Upgrade Code is not unique, ACE20 fails. 


Resolution Type: 


Automatic (CARD20) 


Resolution: 


A new, unique Upgrade Code is automatically generated to replace the duplicate code. 


ACE21 (INI 


Files) 


ACE21 checks entries in the IniFile table to see if they conflict with similar entries in the File table. The IniFile and 
File tables can change the same physical file. As a result, this ACE identifies these duplicate file changes so that they 
can be evaluated. The ACE21 Error String is displayed in the following format: 


The INI file [INI_FILENAME] installed using the IniFile table to the destination 
[PATH_NAME] in the package [PACKAGE1.MSI] conflicts with the same file in the File table 
in the package [PACKAGE2]. 


Summary 
Conflict Type: INI File 
Description: Checks entries in the IniFile table to see if they conflict with similar entries in the File table. 
The IniFile and File tables can change the same physical file. As a result, this ACE 
identifies these duplicate file changes so that they can be evaluated. 
Result: If an entry in the IniFile table of the first MSI package duplicates a file name in a 


component of the File table of the second MSI package, and both are set to be installed to 
the same destination, ACE21 fails. 


Resolution Type: 


Manual 


Resolution: 


Ensure identically named INI files with identical destinations are identical in both the File 
and IniFile tables. This may involve adding or deleting sections or changing values in the 
INI files. 
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Cause 

An entry in the IniFile table of the first MSI package duplicates a file name in a component in the File table of the 
second MSI package and both files are set to be installed to the same destination. 

Resolution 


This conflict requires a manual resolution. Follow these steps: 
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1. In InstallShield DevStudio, open a transform file or MSI package that has an entry in the IniFile table. 


2. Once the project is open, navigate to the INI Files Changes view, and find the INI file entry causing the 
conflict by referring to the INI file name displayed in the error message. 


3. Analyze the sections, keywords, and values in this INI file and compare them to the INI file in the other 
MSI package. Edit the sections, keywords, and values in this INI file so that they match those of the 
second INI file. This may require adding and/or deleting data from the INI File Changes view. 


In order to retrieve the INI file from the other MSI package, you may need to extract it from the MSI file itself 
or a cabinet file if the files are not uncompressed on the source media. 


4. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


5. Open ConflictSolver and reimport this package with its transform file into your Application Catalog, 
and then use the Conflict Wizard to check it against ACE21 again. 


ACE22 (INI Files) 


ACE22 checks file name/target directory pairs in the File table to see if they conflict with similar entries in the IniFile 
table. The IniFile and File tables can change the same physical file. As a result, this ACE identifies these duplicate file 
changes so that they can be evaluated. The ACE22 Error String is displayed in the following format: 


The INI file [INI_FILENAME] installed using the File table to the destination [PATH_NAME] 
in the package [PACKAGE3.MSI] conflicts with the same file in the IniFile table in the 
package [PACKAGE4]. 


Summary 
Conflict Type: INI File 
Description: Checks file name/target directory pairs in the File table to see if they conflict with similar 


entries in the IniFile table. The IniFile and File tables can change the same physical file. As 
a result, this ACE identifies these duplicate file changes so that they can be evaluated. 
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Result: If a file name/target directory pair in a component in the File table is also listed as an 
IniFile table entry, ACE22 fails. 
Resolution Type: Manual 
Resolution: Ensure identically named INI files with identical destinations are identical in both the File 
and IniFile tables. This may involve adding or deleting sections or changing values in the 
INI files. 
Cause 


An INI file in a component of the first MSI package duplicates an entry in the IniFile table of the second MSI 
package and both files are set to be installed to the same destination. 


This conflict requires a manual resolution. Follow these steps: 
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In InstallShield DevStudio, open a transform file or MSI package that has an entry in the IniFile table. 


Once the project is open, navigate to the INI Files Changes view, and find the INI file entry causing the 
conflict by referring to the INI file name displayed in the error message. 


Analyze the sections, keywords, and values in this INI file and compare them to the INI file in the other 
MSI package. Edit the sections, keywords, and values in this INI file so that they match those of the 
second INI file. This may require adding and/or deleting data from the INI File Changes view. 


("4 


In order to retrieve the INI file from the other MSI package, you may need to extract it from the MSI file itself 
or a cabinet file if the files are not uncompressed on the source media. 


Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


Open ConflictSolver and reimport this package with its transform file into your Application Catalog, 
and then use the Conflict Wizard to check it against ACE22 again. 
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ACE23 (Files) 


@— 


e 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


ACE23 identifies file duplication between source and target packages. ACE23 checks to see if files with the same 
name and destination directory have the same size, version, and language when comparing a source package against a 
target package. If a file with the same name and destination directory is found in both the source and target packages, 
but the file has a different size, version, or language, ACE23 fails. 


The ACE23 Error String is displayed in the following format: 


The file [EXECUTABLE_FILENAME, SIZE, VERSION, LANGUAGE] installed to location [PATHNAME ] 
by component [COMPONENT1] in Package [PACKAGE1] conflicts with the same file in component 
[COMPONENT2] in Package [PACKAGE2]. 


ACE23 can be used in conflict analysis when MSI Package, OS Snapshot File, or Marimba NCP File data types are 
selected as either source or target packages. However, if you specify only Marimba NCP Files as your source 
packages, ACE23 and ACE24 will be the only ACEs that you can select on the Conflict Options Panel of the Conflict 
Wizard. All other ACEs will be unavailable. 


Summary 
Conflict Type: Files 
Description: Checks to see if files with the same name and destination directory have the same size, 
version, and language. 
Result: If a file with the same name and destination directory is found in both the source and 
target package, but the file has a different size, version, or language, ACE23 fails. 
Resolution Type: Manual 
Resolution: Investigate and decide which file has precedence. If the source file has precedence over 
the target file, remove the target file. 
Cause 


A file with the same name and destination directory is found in both the source and target package, but the file has a 
different size, version, or language. 


InstallShield Software Corporation © 2004 799 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


This conflict requires a manual resolution. Use ONE of the following solutions: 


Replace the file in the source package with the same file found in the target package 


Retrieve a copy of the file from the operating system in which the target package was taken. 
Open a transform file or MSI package in InstallShield DevStudio. 


Once the project is open, navigate to the Files and Folders view, and find the file causing the conflict. 
Replace that file with the one retrieved from the operating system. 


Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


Open ConflictSolver and reimport this package with its transform file into your Application Catalog, 
and then use the Conflict Wizard to check it against ACE23 again. 


Change the destination of the component that installs the file in the MSI package 


2. 


Open a transform file or MSI package in InstallShield DevStudio. 


Once the project is open, navigate to the Components view, and select the component that contains the 
file causing the conflict. 


In order to quickly find the component name, go to the File Table via the Direct Editor view and search for the 
file name. Then, check the component column for the component name. 


Select the Destination field of the component from the Property grid and change it to a new destination. 


Changing the destination may cause the application to break. Before changing the destination, verify that the 
application will still work using the new destination. 


Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


Open ConflictSolver and reimport this package with its transform file into your Application Catalog, 
and then use the Conflict Wizard to check it against ACE23 again. 
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ACE24 (Registry) 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


ACE 24 checks to see if registry entries with the same registry hive, key, and value name have the same data type and 
value. If a registry entry with the same registry hive, key, and value name in a package is found in both the source and 
target package, but the registry entry has a different data type or value, ACE24 fails. 


The ACE24 Error String is displayed in the following format: 


The registry entry [REGISTRY_ENTRY] in [PACKAGE1] conflicts with the same registry entry 
in the [COMPONENT] in [PACKAGE2]. 


ACE24 can be used in conflict analysis when MSI Package, OS Snapshot File, or Marimba NCP File data types are 
selected as either source or target packages. However, if you specify only Marimba NCP Files as your source 
packages, ACE23 and ACE24 will be the only ACEs that you can select on the Conflict Options Panel of the Conflict 
Wizard. All other ACEs will be unavailable. 


Summary 

Conflict Type: Registry 

Description: Checks to see if registry entries with the same registry hive, key, and value name have the 
same data type and value. 

Result: If a registry entry with the same registry hive, key, and value name in a package is found 
in both the source and target packages, but the registry entry has a different data type or 
value, ACE24 fails. 

Resolution Type: Manual 

Resolution: Investigate and decide which registry entry has precedence. If the source registry entry has 
precedence over the target registry entry, remove the target registry entry. 

Cause 


A registry entry with the same registry hive, key, and value name in a package is found in both the source and target 
package, but the registry entry has a different data type or value. 
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This conflict requires a manual resolution. Follow these steps: 


{e \ 


To resolve this conflict: 
1. Open a transform file or MSI package in InstallShield DevStudio. 


2. Once the project is open, navigate to the Registry view, and find the registry value causing the conflict. 
Replace that value with the same registry value and data type found in the target package. 


3. Select Save As from the File menu and save the changes as a Windows Installer Transform (.mst) file. 


4. Open ConflictSolver and reimport this package with its transform file into your Application Catalog, 
and then use the Conflict Wizard to check it against ACE24 again. 


User-Defined ACEs 


In addition to business rules (ACEs) shipped with ConflictSolver, you can also create your own company-specific 
business rules to use when detecting conflicts. For example, your organization may want to identify (and change) any 
VBScript custom actions that have a hard-coded drive letter, any applications that create desktop or uninstall 
shortcuts, any applications that have Startup registry entries, or any applications that place files in the system directory. 
You can create custom rules to identify these (and many more company-specific situations) using ConflictSolver. 


Creation of user-defined ACHs is done using the Rules Wizard. 


Types of User-Defined ACEs 


In addition to the ACEs included with ConflictSolver, you can also create your own user-defined ACEs to use when 
detecting conflicts. You can create three types of ACEs: 


Custom - Source Only Packages ACEs 


Custom - Source Only Packages ACEs allow you to quickly test any column or any value of a table to support your 
business logic. For example, you could use a user-defined ACE to identify packages that create a desktop icon. To 
define a Source Only Packages ACE, you must define a SQL "Where" clause. 
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ConflictSolver supports external package conflict checking for Custom - Source Only Packages ACEs. The Source 
package can be selected from the ConflictSolver Application Catalog Database or from an external MSI package. 
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Custom - Source and Target Packages ACEs 


Custom - Source and Target Packages ACEs allow you to compare columns or values of Source package tables (new 
packages that you want to install onto a user's system) to columns or values of Target package tables (packages already 
installed on a user's system). For example, you could use a Source and Target Packages ACE to determine if the 
installation of a Source package onto a Target system would overwrite or conflict with an existing entry in the .ini file 
in the System directory of the Target system. To define a Source and Target Packages ACE, you must define a SQL 
"Where" clause, and specify a Join Column—a table column in the Application Catalog database that has a matching 
value for both the Source and Target packages. Rows in each of the packages that have a matching value in the Join 
Column ate selected and those rows are checked against the Source and Target Packages. 


A 
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ConflictSolver does not support external package conflict checking for Custom - Source and Target Packages ACEs. 
Both the Source and Target Packages must be selected from the ConflictSolver Application Catalog Database. 


DLL - User Provided DLL Based ACEs 


DLL - User Provided DLL Based ACEs allow you to run more complex tests—testing many tables in any 
combination. For example, you could use a DLL-Based ACE to confirm that a source product language is the same as 
all target product languages. To define a DLL-Based ACE, you use SQL and various programming languages to 
construct a Windows DLL. With DLL-Based ACEs, you can use a Conflict Application Resolution Definition 
(CARD) to fix the conflict. 


Where You Create User-Defined ACEs 


When creating ACEs, you need to provide basic information for display in the Rules viewer, Conflicts tab of the 
Options dialog, and in the Output window. You must associate a table with the ACE. You also must categorize the 
ACE (either using existing ACE categories or by creating your own). 


Creation of User-Defined ACEs is done using the Rules Wizard. You can view and edit ACEs by launching the Rules 
Viewer, and opening an ACE in the ACE Rule Properties Dialog. 


Creating User-Defined ACEs 


User-Defined ACEs 


In addition to business rules (ACEs) shipped with ConflictSolver, you can also create your own company-specific 
business rules to use when detecting conflicts. For example, your organization may want to identify (and change) any 
VBScript custom actions that have a hard-coded drive letter, any applications that create desktop or uninstall 
shortcuts, any applications that have Startup registry entries, or any applications that place files in the system directory. 
You can create custom rules to identify these (and many more company-specific situations) using ConflictSolver. 


Creation of user-defined ACHs is done using the Rules Wizard. 
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Creating a Custom/Source Only Packages ACE 


You can create a user-defined ACE to apply to Source Only Packages. One common task you may want to create a 
Source Only Packages ACE to handle is to identify packages which create a desktop icon. 


ConflictSolver supports external package conflict checking for Custom - Source Only Packages ACEs. The Source 
package can be selected from the ContflictSolver Application Catalog Database or from an external MSI package. 


To create a Source Only Packages ACE that identifies desktop icon creation: 
1. Launch ConflictSolver. 


2. From the Conflicts menu, select Rules Viewer. The Rules Viewer Dialog opens. 


Rules Viewer 


Rules 
S (& Conflict Types 
4) Components 
H- File Extensions 
Files 
B- INI Files 
4 short ACE description displayed when selecting an ACE to execute, 
ACE14 - Confirm that a INI Files exist in only one component 
ACE21 - Check INI file entries From the IniFile table in the File table 
4CE22 - Check INI file entries From the File table in the IniFile table 
H-E NT Services 
H- ODBC Resources 
w- Product Properties 
HE) Registry 
w- Shortcuts 


4 description of the ACE displayed during ACE execution, 
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3. In the Rules Viewer, click New to launch the Rules Wizard. The Rules Wizard Welcome Panel opens. 


Rules Wizard 


Welcome to the Rules Wizard 


The Rules Wizard allows you to create and edit 
custom ACE rules for later use by the Conflict 
Wizard. 


Click Next to continue. 


General Information 
Specify the options common to all ACEs. 


AIL ACEs require basic information for display and identification. Supply the required data for 
the following properties: 


Name: 
Associated Table: 


Brief Description: 


4 short ACE description displayed when selecting an ACE to execute. 
Description: EA Se ee et se eee es 

4 description of the ACE displayed during ACE execution. 

Information URL: 


http: //wwwy.pourcompany.com 


EEEE (tones) (he) 
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5. In the General Information Panel, input the following values: 


Property Value 

Name MYACE 

Associated Table csmsiShortcut 

Brief Description MYACE - Find desktop icons 

Description Locates packages that create desktop icons. 
Information URL hitp://www.yourcompany.com/MYACE.htm 


6. Click Next. The Additional Information Panel opens. 


Rules Wizard 


Additional Information 
Configure options for categorizing the ACE. 


Additional information is necessary to categorize the ACE during conflict identification. 
Supply the required data for the following properties: 


Category: 
|l 


Rule Type: 


| Custom - Source Only Packages 


7. In the Additional Information Panel, use the following values for properties: 


Property Value 
Category Shortcuts 
Rule Type Custom - Source Only Packages 
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8. Click Next. The Custom Options Panel opens. 


Rules Wizard 


Custom Options 
Configure options for categorizing the custom ACE. 


Custom rules have specific display options which need to be specified. Supply the required 
data for the following properties: 


Error String: i 
Display String: 


Severity 
© Warming [C] Report 'No' results 
O Eror 


Cancel Help 


9. In the Custom Options Panel, use the following values for properties: 


Property Value 

Error String Desktop icons [Name] are not allowed. 
Display String A desktop icon called [Name] is created. 
Severity Warning 

Report 'No' Results Deselected 


In the example above, [Name] is a token. Tokens allow you to insert values at run-time from the internal 
Conflict Solver Application Catalog Database or from an external MSI package into the Error or 
Display string. To use token replacement in a string, click the arrow to the right of the Error String and 
Display String text boxes and select a column name from the list. The column name is then inserted into 
the string in the following format: [ColumnName]. 


Á — 
= 


The Token list is provided for your convenience; if you prefer, you can type the tokens directly in the text 
boxes. You could also use the [ProductName] pseudo-token to insert the name of the package in a message, 
even though ProductName is not a table column name. 
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10. Click Next. The Where Clause Panel opens. 


Rules Wizard 


Where Clause 
Specify the information required for custom ACEs. 


Custom ACEs require a SQL Where clause to operate. Enter a valid Where clause below, or 
use the Expression Builder to construct one. 


Where Clause: 


| 


Build Expression... 
Join Column 


Expression Builder 


Table Columns 


Comparison Operator 


Constant 


Expression Operator 
AND OR 


12. In the Expression Builder, specify the following: 


Setting Value 
Table Columns [Directory_] 
Comparison Operator = (Equal To) 
String Constant DesktopFolder 


13. Click OK to close the Expression Builder and return to the Where Clause Panel. The expression that you 
just built is now displayed in the Where Clause text box: 


[Directory_] = 'DesktopFolder' 
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When you are constructing simple expressions, it is helpful to use the Expression Builder dialog, but you are 
not limited to the formatting options that the Expression Builder provides to you. If you know how to write 
Where clauses in SQL, you can use significantly more powerful expressions by entering them directly in the 
Where Clause text box on the Where Clause Panel or on the Where Clause Tab of the ACE Rule Properties 
Dialog. 


14. Click Test to validate the expression. 


15. Click Next. The Summary Panel opens. 


Rules Wizard 


Summary 
Review selections for this ACE. 


4, custom ACE called, 'MYACE", will be created with the following options: 


Category Name: Shortcuts 
Description: Locates packages that create desktop icons 
Brief Description: MYACE - Find desktop icons 
http: //www.pourcompany.com/MYACE. htm 
csmsiShortcut 


Error String: Desktop icons [Name] are not allowed. 
Display String: À desktop icon called [Name] is created. 
Error Type: Warning 

Report No Results: No 

Source Only: Yes 


where’ Clause: [Directory_] = 'DesktopFolder' 


Click Finish to accept these options. 


16. On the Summary Panel, review the summary of your new ACE and click Finish. 


17. Click Close to exit the Rules Viewer. This new user-created ACE is now available for use in subsequent 
conflict identification. 


Creating a Custom/Source and Target Packages ACE 


You can create a custom ACE to apply to Source and Target Packages. For example, you could use a Source and 
Target Packages ACE to determine if the installation of a Source package onto a Target system would overwrite or 
conflict with an existing entry in the .ini file in the System directory of the Target system. 


ConflictSolver does not support external package conflict checking for Custom - Source and Target Packages ACEs. 
Both the Source and Target Packages must be selected from the ConflictSolver Application Catalog Database. If you 
attempt to run a conflict check on an external MSI package using a Source and Target Packages ACE, that custom ACE 
will not be executed. 
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Ne 


To create a Source and Target Packages ACE that identifies .ini file conflicts: 
1. Launch ConflictSolver. 


2. From the Conflicts menu, select Rules Viewer. The Rules Viewer Dialog opens. 


Rules Viewer 


Rules 

= © Conflict Types 
H- Components 
w- File Extensions 
H Files 
H-E INI Files 
H- NT Services 
H-E ODBC Resources 
(4-5) Product Properties 
HS) Registry 
-E Shortcuts 


3. In the Rules Viewer, click New to launch the Rules Wizard. The Rules Wizard Welcome Panel opens. 


Rules Wizard 


Welcome to the Rules Wizard 


The Rules Wizard allows you to create and edit 
custom ACE rules for later use by the Conflict 
Wizard. 


Click Next to continue. 


ETE MTM 
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4. On the Welcome panel, click Next. The General Information Panel opens. 


Rules Wizard 


General Information 
Specify the options common to all ACEs. 


All ACEs require basic information for display and identification. Supply the required data for 
the following properties: 


Name: 


CustomRule2 


Associated Table: 


Brief Description: 
Å short ACE description displayed when selecting an ACE to execute. 


Description: 


4 description of the ACE displayed during ACE execution. 


Information URL: 


http: //www.yourcompany.com 


(etek Jie) (tures) (He) 


5. In the General Information Panel, input the following values: 


Property Value 

Name INICheck 

Associated Table esmsilniFile 

Brief Description INICheck - Identifies conflicts found in an .ini file. 

Description Determines if the installation of a Source package onto a Target system would 
overwrite or conflict with an existing entry in the .ini file in the Target system's 
System directory. 

Information URL hitp://www.yourcompany.com/INICheck. htm 
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6. Click Next. The Additional Information Panel opens. 


Rules Wizard 


Additional Information 
Configure options for categorizing the ACE. 


Additional information is necessary to categorize the ACE during conflict identification. 
Supply the required data for the following properties: 


Category: 


Rule Type: 


| Custom - Source Only Packages 


[cise Jones) (tans) (te) 


7. In the Additional Information Panel, use the following values for properties: 


Property Value 
Category INI Files 
Rule Type Custom - Source and Target Packages 


8. Click Next. The Custom Options Panel opens. 


Rules Wizard 


Custom Options 
Configure options for categorizing the custom ACE. 


Custom rules have specific display options which need to be specified. Supply the required 
data for the following properties: 


Error String: 
| 


Display String: 


Severity 
© warming C Repott 'No' results 
O Eror 


9. In the Custom Options Panel, use the following values for properties: 
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Property Value 


Error String The INI file called [Source.FileName] in the directory [Source.csFullPath] writes to 
the [Source.Section] section which is also written by the target package, 
[Target.ProductName]. 


Display String The INI file called [Source.FileName] in the directory [Source.csFullPath] writes to 
the [Source.Section] section. 


Severity Warning 


Report 'No' Results Deselected 


In the example above, [Source.Filename], [Source.csFullPath] and [Source.Section] are tokens. Tokens 
allow you to insert values at runtime from the internal Conflict Solver Application Catalog Database into 
the Error or Display string. To use token replacement in a string, click the arrow to the right of the Error 
String or Display String text boxes and select a column name from the list. The column name is then 
inserted into the string in the format of [Source.ColumnName] or [Target.ColumnName], with the prefix 
identifying whether the column is in the Source or Target package. 


The Token list is provided for your convenience; if you prefer, you can type the variables directly in the text 
boxes. 


You can also use the [Target.ProductName] and [Source.ProductName] pseudo-tokens to insert the 


name of the Source or Target package in a message, even though ProductName is not a table column 
name. 
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10. Click Next. The Where Clause Panel opens. 


Rules Wizard 


Where Clause 
Specify the information required for custom ACEs. 


Custom ACEs require a SQL Where clause to operate. Enter a valid Where clause below, or 
use the Expression Builder to construct one. 


Where Clause: 


| 


Build Expression... 


Join Column 


Expression Builder 


Table Columns 


Comparison Operator 


Constant 


Expression Operator 
AND OR 


12. In the Expression Builder, specify the following: 


Value 
Table Columns [Source]. [csFullPath] 
Comparison = (Equal To) 
Operator 
String Constant SystemFolder 


13. Click OK to close the Expression Builder and return to the Where Clause Panel. The expression that you 
just built is now displayed in the Where Clause text box: 


[Source].[csFullPath] = 'SystemFolder' 
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When you are constructing simple expressions, it is helpful to use the Expression Builder dialog, but you are 
not limited to the formatting options that the Expression Builder provides to you. If you know how to write 
Where clauses in SQL, you can use significantly more powerful expressions by entering them directly in the 
Where Clause text box on the Where Clause Panel or on the Where Clause Tab of the ACE Rule Properties 
Dialog. 


14. On the Where Clause Panel, click Build Expression again. 


15. In the Expression Builder, specify the following: 


Setting Value 

Table Columns [Source].[Section] 
Comparison Operator = (Equal To) 
String Constant [Target]. [Section] 
Expression Operator AND 


When using the Expression Builder Dialog to create a Source and Target Packages custom ACE to compare 
the value of a column in the source table to the value of a column in the target table, you can select the first 
table column name from the Table Columns list. However, you have to manually enter the second table column 
name in the Constant text box. When doing so, enter the table column name using the same syntax that is 
used in the Table Columns list: [Source] .[ColumnName] or [Target].[ColumnName]. 


16. Click OK to close the Expression Builder and return to the Where Clause Panel. The expression that you 
just built is now displayed in the Where Clause text box, amended to the end of the first expression you 


built: 
[Source].[csFullPath] = 'SystemFolder' AND 
[Source].[Section] = '[Target].[Section]' 


17. Select csFullPath from the Join Column list. 
The Join Column is a table column in the Application Catalog database that has a matching value for 


both the Source and Target packages. Rows in each of the packages that have a matching value in the 
Join Column are selected and those rows are checked against the Source and Target Packages. 
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18. Click Test to validate the expression. A message appears stating that the query executed properly. 


InstallShield ConflictSolver 


i ) The query, ‘SELECT [Source]. *, [Target]. * FROM [csmsilniFile] 45 [Source], [csmsilniFile] 45 [Target] WHERE 


[Target]. [csFullPath] = 'SystemFolder’ AND [Source], [Section] = '[Target].[Section]", executed properly, 


19. Click Next. The Summary Panel opens. 


Rules Wizard 


Summary 
Review selections for this ACE. 


Å custom ACE called, 'INICheck', will be created with the following options: 


Category Name: INI Files 
Description: Determines if the installation of a Source package onto a T 
Brief Description: INICheck - Identifies conflicts found in an .ini file. 
http://www. yourcompany.com/INICheck. htm 
csmsilniFile 
Error String: The INI file called (Source. FileName] in the directory [Sourc 
Display String: The INI file called (Source. FileN ame] in the directory [Sourc 
Error Type: Waring 
Report No Results: No 
Source Only: No 


"Where" Clause: [T arget].[csFullPath] = 'SystemFolder’ AND [Source]. [Secti — 
Join Column: csFullPath v 
< ill 


Click Finish to accept these options. 


Finish | Cancel Help 


20. On the Summary Panel, review the summary of your new ACE and click Finish. 


21. Click Close to exit the Rules Viewer. This new Custom ACE is now available for use in subsequent 
conflict identification. 


Creating a User Provided DLL-Based ACE 


To demonstrate how to create a DLL-Based ACE, an ACE SDK was installed with AdminStudio, in the following 
directory: 


\ProgramFi les\Instal1Shield\AdminStudio\5.5\ConflictSolver\ACESDK 


Included in this directory is a VC++ 6.0 DLL-based project which is a fully formed example ACE. This example 
includes utility functions that allow you to integrate your own ACE execution within our conflict persistence model. 
To learn how to create a DLL-Based ACE, use the ACE SDK files to perform the following steps: 


g` 


Bi 
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1. Launch Windows Explorer and navigate to the following directory: 


\ProgramFi les\Instal1Shield\AdminStudio\5.5\CconflictSolver\ACESDK 


2. Copy this folder and its contents and store it in a convenient location. 


3. Launch VC++ 6.0 and open the ACESDK.dsp project file within that newly created folder. 


4. Review the code and make any desired changes. 


5. Still in VC++ 6.0, build the ACESDK.dsp project to create a new .DLL file. 


6. Launch ConflictSolver. 


7. From the Conflicts menu, select Rules Viewer. The Rules Viewer Dialog opens. 


Rules Viewer 


Rules 

| =) © Conflict Types 

| H- Components 

| w- File Extensions 
E> Files 

| B- INI Files 

| H- NT Services 

| 

| 


H- ODBC Resources 
E- Product Properties 
HC) Registry 

-E Shortcuts 
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8. On the Rules Viewer, click New to launch the Rules Wizard. The Rules Wizard Welcome Panel opens. 


Rules Wizard 


Welcome to the Rules Wizard 


The Rules Wizard allows you to create and edit 
custom ACE rules for later use by the Conflict 
Wizard. 


Click Next to continue. 


Rules Wizard 


General Information 
Specify the options common to all ACEs. 


All ACEs require basic information for display and identification. Supply the required data for 
the following properties: 


Name: 
Associated Table: 


Brief Description: 


Å short ACE description displayed when selecting an ACE to execute. 


ESRI aes ct ae na gees ener 
4 description of the ACE displayed during ACE execution. 


Information URL: 


http: //wwwy.yourcompany.com 


10. In the General Information Panel, input the following values: 


Property Value 
Name ACELanguage 
Associated Table csmsiProperty 
(This is the ConflictSolver table associated with this example ACE.) 
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Property Value 

Brief Description ACELanguage - Check product language consistency. 

Description Confirm that source product language is the same as all target product 
languages. 

Information URL hitp://www.yourcompany.com/ACELanguage.htm 


11. Click Next. The Additional Information Panel opens. 


Rules Wizard 


Additional Information 
Configure options for categorizing the ACE. 


Additional information is necessary to categorize the ACE during conflict identification. 
Supply the required data for the following properties: 


Category: 


Rule Type: 


| Custom - Source Only Packages 


[cise Jone] (tans) (te) 


12. In the Additional Information Panel, use the following values for properties: 


Property Value 
Category Type in a new category name: Product Language 
Rule Type DLL - User Provided DLL 
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13. Click Next. The DLL-Based ACEs Panel opens. 


Rules Wizard 


DLL-Based ACEs 
Specify the information required for DLL-based ACEs. 


DLL-based ACEs require specific information about the DLL and ACE function name to 
operate. Provide the requested information below. 


ACE/CARD DLL File: 


Í 


ACE Function Name: 


| 


CARD Function Name [optional]: 


Cancel Help 


14. In the DLl-Based ACEs Panel, fill in the following information: 


Setting Value 


ACE/CARD DLL File Click Browse and select the DLL that you built in Step 5 above. 


ACE Function Name ExampleACE (as designed in the sample) 


CARD Function ExampleCARD (as designed in the sample) 
Name 


15. Click Test next to ACE Function Name or CARD Function Name to validate that the exported function 
does exist. 
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16. Click Next. The Summary Panel opens. 


Rules Wizard 


Summary 
Review selections for this ACE. 


4 DLL-based ACE called, ‘ACELanguage'’, will be created with the following options: 


Category Name: Product Language 

Description: Confirm that source product language is the same as all target | 
Brief Description: ACELanguage - Check product language consistency. 

Help URL: URL http: //www.yourcompany.com/&CE Language. htm 
Associated T able: csmsiProperty 


C:\AdminStudio Shared\MSO.DLL 
ExampleA4CE 
CARD Function: ExampleCA4RD 


Click Finish to accept these options. 


17. On the Summary Panel, review the summary of your new ACE and click Finish. 


18. Click Close to exit the Rules Viewer. This new DLL-Based ACE is now available for use in subsequent 
conflict identification. 
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Editing User-Defined ACEs 


To edit a user-defined ACE: 


1. From the Conflicts menu, select Rules Viewer. The Rules Viewer Dialog opens. 


Rules Viewer 


Rules 
S (& Conflict Types 
H- Components 
wH- File Extensions 
w- Files 
B- INI Files 
4 short ACE description displayed when selecting an ACE to execute. 
ACE14 - Confirm that a INI files exist in only one component 
ACE21 - Check INI file entries From the IniFile table in the File table 
ACE22 - Check INI file entries From the File table in the IniFile table 
W- NT Services 
H-E ODBC Resources 
-C Product Properties 
Hy Registry 
w- Shortcuts 


4 description of the ACE displayed during ACE execution. 


2. In the Rules Viewer Dialog, select the user-defined ACE you want to modify and click Edit. The ACE 
Rule Properties Dialog opens. 


ACE Rule Properties 


General Information | Additional Information | Custom Options | Where Clause | 


All ACEs require basic information for display and identification. Supply the required data for 
the following properties: 


Name: 


CustomRule1 


Associated T able: 


csmsiDirectory 


Brief Description: 


4 short ACE description displayed when selecting an ACE to execute. 


Description: 


4 description of the ACE displayed during ACE execution. 


Information URL: 


http: //wwwy.yourcompany.com 


ee ee P 


3. In the ACE Rule Properties Dialog, edit the properties as necessary. 
4. Click OK to close the dialog. 


5. Click Close to exit the Rules Viewer dialog. The modified ACE is available for use in subsequent conflict 
identification. 
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Deleting User-Defined ACEs 


To delete a user-defined ACE: 


1. From the Conflicts menu, select Rules Viewer. The Rules Viewer Dialog opens. 


Rules Viewer 


Rules 


S (& Conflict Types 

H- Components 

wH- File Extensions 

w- Files 

B- INI Files 
4 short ACE description displayed when selecting an ACE to execute. 
ACE14 - Confirm that a INI files exist in only one component 
ACE21 - Check INI file entries From the IniFile table in the File table 
ACE22 - Check INI file entries From the File table in the IniFile table 

5) NT Services 

H-E ODBC Resources 

-C Product Properties 

Hy Registry 

ty Shortcuts 


4 description of the ACE displayed during ACE execution. 


2. In the Rules Viewer Dialog, select the ACE you want to remove and click Delete. 


3. Confirm the deletion. 


The user-defined ACE is removed from the available rules. If this ACE was the only one in a user-defined ACE 
category, the category will be removed when you close the Rules Viewer dialog. 
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Viewing ACE Metrics 


When ACHs are run, ConflictSolver generates metrics and logs them in the AceLog.txt file, located in the following 
directory: 


AdminStudio Shared\conflictSolver\AceLog.txt 


The following is an example of the beginning of an AceLog.txt file: 


11/06/03 09:26:35 ACE/CARD Execution started 


SELECT DISTINCT csmsiComponent.Component, csmsiComponent.Componenttid, 
csmsiComponent.RowID FROM csmsiComponent WHERE csmsiComponent.PkgRowID_ = 5 


Records returned =>(124) 


Query Time =>(0.23 seconds) 


SELECT csmsiFile.FileName FROM csmsiFile WHERE csmsiFile.Component_ = 
"DeletedLinks.10' AND csmsiFile.PkgRowID_ = 5 ORDER BY csmsiFile.FileName 


Records returned =>(0) 
Query Time =>(0.07 seconds) 


Time taken to execute (ACE03) : 1.06 seconds 


SELECT [fs].[RowID], [ft].[RowID], [ft].[PkgRowID_], [ft].[FileName], 
[cs].[Component], [ct].[Component], [cs].[ComponentiId], [ct].[ComponentId], 
[fs].[version], [fs].[Filesize], [fs].[Language] FROM (([csmsiFile] AS [fs] 
INNER JOIN [csmsiFile] AS [ft] ON (C [fs].[FileName] = [ft]. [FileName] 

AND [fs].[Version] = [ft].[Version] AND [fs].[FileSize] = [ft].[FileSize] AND 
[fs].[Language] = [ft].[Language]) ) INNER JOIN [csmsiComponent] AS [cs] ON 
[fs].[PkgRowID_] = [cs].[PkgRowID_] AND [cs].[Component] = [fs]. [Component_]) 
INNER JOIN [csmsiCcomponent] AS [ct] ON [ft].[PkgRowID_] = [ct].[PkgRowID_] AND 
[cs].[ComponentId] <> [ct].[ComponentId] AND [cs].[csFul]lPath] = [ct]. [csFullPath] 
AND [ct].[Component] = [ft].[Component_] WHERE [fs].[PkgRowID_] = 5 AND 

[ft]. [PkgRowID_] IN (4) 


Records returned =>(0) 


Query Time =>(0.10 seconds) 


Time taken to execute (ACEO7) : 0.74 seconds 


SELECT [cs].[Component] AS [SrcComponent], [fs].[RowID] AS [SrcRowID], 
[ft]. [RowID] AS [TargetRowID], [ft].[PkgRowID_] AS [TargetPkgRowID] , 
[fs].[version] AS [Srcversion], [fs].[FileName], [cs].[csFullPath], 
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[ct].[Component] AS [TargetComponent], [ft].[Version] AS [Targetversion] 

FROM (C[csmsiFile] AS [fs] INNER JOIN [csmsiFile] AS [ft] ON [fs].[FileName] = 
[ft].[FileName]) INNER JOIN [csmsicomponent] AS [cs] ON [cs].[PkgRowID_] = 
[fs].[PkgRowID_] AND [cs].[Component] = [fs].[Component_]) INNER JOIN 
[csmsicomponent] AS [ct] ON [cs].[ComponentiId] = [ct].[ComponentId] AND 
{[ct].[PkgRowID_] = [ft].[PkgRowID_] AND [ct].[Component] = [ft]. [Component_] 
AND [cs].[csFullPath] = [ct].[csFullPath] WHERE [fs].[PkgRowID_] = 5 

AND [ft].[PkgRowID_] IN (4) AND ([fs].[Version] <> [ft].[version] OR 
C{fs].[Version] IS NULL AND [ft].[Version] IS NOT NULL) OR (C[ft].[Version] 

IS NULL AND [fs].[Version] IS NOT NULL)) 


Records returned =>(0) 
Query Time =>(0.09 seconds) 


Time taken to execute (ACE08) : 0.73 seconds 


Conflict Application Resolution 
Definitions (CARDs) 


Conflict Application Resolution Definitions (CARDs) are the rules used to fix conflicts identified by Application 
Conflict Evaluators (ACEs) when conflict detection is performed. Before a CARD is run, you are given the 
opportunity to review how the CARD will resolve the conflict and decide whether or not to perform the resolution. 
See CARD Resolution Process for more information. 


The following links, grouped by conflict type, explain each CARD. 


Conflict Type Associated Resolutions 
Component CARDO2, CARDO4, CARDO5, CARDO6 
Files CARDO7 

ODBC Resources CARD15 

Product Properties CARD18, CARD19, CARD20 
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The following list provides links to each individual Conflict Application Resolution Definition (CARD) and its 
associated ACE (Application Conflict Evaluators). These CARDs are used to resolve conflicts between installation 
packages that were identified by the CARD's corresponding ACE. 


Conflicts found by ACEs that do not have associated CARDs must be resolved manually. See ACE Index for more 


information. 
CARD Brief Description of ACE Action Taken by CARD 
CARDO2 for ACEO2 Checks to see if components in different The destination path of the component in the 
packages that have matching Source package is automatically set to 
Componentlds also have identical match that of the component in the Target 
destination paths. package. 
CARDO4 for ACEO4 Checks to see if components that have A CreateFolder entry is created for the 


NULL KeyPath values are valid by checking 
for an entry for the component in the 
CreateFolder table. 


component. 


CARDO5 for ACEO5 


Checks for the existence of more than one 
executable (EXE, DLL, OCX, HLP, CHM, 
TLB, SYS, DRV) per component in a 
Windows Installer package. 


Modifies the component so that only one 
EXE or DLL exists, and it adds new 
components for remaining EXE, DLL, OCX, 
HLP, CHM, TLB, SYS, and DRV files. 


components with different Componentlds. 


CARDO6 for ACEO6 Checks whether the executable module The executable module is automatically 
(EXE, DLL, OCX, HLP, CHM, TLB, SYS, or made the key file. 
DRY) within the component is the key file. 

CARDO7 for ACEO7 Checks for the existence of the same file in The Source package Componentld is 


changed to match the Target package 
Component Id. 


CARD15 for ACE15 


Checks for the existence of identical ODBC 
entries in components with different 
Componentlds. 


ConflictSolver changes the Source 
Componentld to match that of the Target 
Componentld. 


unique. 


CARD 18 for ACE18 Checks the Package Code to see if it is A new, unique Package Code is 
unique. automatically generated to replace the 
duplicate code. 
CARD19 for ACE19 Checks the Product Code to see if it is A new, unique Product Code is 
unique. automatically generated to replace the 
duplicate code. 
CARD20 for ACE20 Checks the Upgrade Code to see if it is A new, unique Upgrade Code is 


automatically generated to replace the 
duplicate code. 
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Before a CARD is run, you are given the opportunity to review how the CARD will resolve the conflict and decide 
whether or not to perform the resolution. See CARD Resolution Process for more information 


CARDO2 (Components) 


CARD02 resolves ACE02, which checks to see if components in different packages that have matching 
Componentlds also have identical destination paths. If components with the same Componentld have different 
destination paths, ACE02 fails. 


CARD0O2 automatically sets the destination path of the component in the Source package to match that of the 
component in the Target package. To do this, CARD02 runs the following query and replaces the Directory_ column 
with a run-time translation of the targets component (csFullPath) path using 
MsiDBUtils::GetDirectoryTargetPathKey. 


SELECT Directory_ FROM ‘Component 
WHERE ComponentId='Source Componentid' 


CARDO4 (Components) 


CARD04 resolves ACE04, which checks to see if components that have NULL KeyPath values are valid by checking 
for an entry for the component in the CreateFolder table. If a component does not have a key file, and if the 
directory/component pair is not listed in the CreateFolder table, ACE04 fails. 


CARD04 creates a CreateFolder entry for the component by executing the following query: 


INSERT INTO CreateFolder ( Directory_ , Component_ ) 
VALUES ('Source Directory','Source Component") 
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CARDOS5 (Components) 


CARD05 resolves ACE05, which checks for the existence of more than one executable (EXE, DLL, OCX, HLP, 
CHM, TLB, SYS, DRV) per component in a Windows Installer package. If more than one executable exists in a 
component, ACE05 fails. 


CARD05 modifies the component so that only one EXE or DLL exists, and it adds new components for remaining 
EXE, DLL, OCX, HLP, CHM, TLB, SYS, and DRV files. To do this, CARD05 generates a new component name 
and Componentld and inserts a record in the Component table and FeatureComponents table. The relevant entry in 
the File table would then be updated to effectively move the file into the new component. 


CARDO6G (Components) 


CARD06 resolves ACE06, which checks whether the executable module (EXE, DLL, OCX, HLP, CHM, TLB, SYS, 
ot DRV) within the component is the key file. If the executable module is not the key file, ACE06 fails. 


CARD06 automatically makes the executable module the key file. to do this, CARD06 runs the following query and 
replaces the KeyPath with an entry from the File Table - File Column which is associated with this component and of 
the correct type. 


SELECT KeyPath FROM Component’ WHERE ` 
ComponentId = 'Source Componenttid' 


CARDO7 (Files) 


CARD07 resolves ACE07, which checks for the existence of the same file in components with different 
Componentlds. If the same file exists in components with different ComponentIds, ACE07 fails. 


CARD07 changes the Source package Componentld to match the Target package Component Id. To do this, 
CARD07 runs the following query against the source package and then updates the Componentld with the 
Componentld from the target package: 


SELECT ComponentId FROM Component WHERE 
Component = ‘Source Package Componentid' 
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CARD15 (ODBC Resources) 


CARD15 resolves ACE15, which checks for the existence of identical ODBC entries in components with different 
Componentlds. If identical ODBC entries exist in components with different ComponentlIds, ACE15 fails. 


CARD 15 changes the Source Componentld to match that of the Target Componentld. To do this, CARD15 runs the 
following query against the source package and then updates the Componentld with the Componentld from the 
target package: 


SELECT ComponentId FROM 
Component WHERE ‘Component = ‘Source Package Componentid' 


CARD18 (Product Properties) 


CARD 18 resolves ACE18, which checks the Package Code to see if it is unique. If the Package Code is identical to 
any other Package Code in ConflictSolver, ACE18 fails. 


CARD 18 updates the PackageCode by inserting a newly generated GUID into the MSI package using 
MsiSummaryInfoSetProperty. 


CARD19 (Product Properties) 


CARD19 resolves ACE19, which checks the Product Code to see if it is unique. If the Product Code is identical to 
any other Product Code in ConflictSolver, ACE19 fails. 


CARD19 automatically generates a new, unique Product Code to replace the duplicate code. To do this, CARD19 
runs the following query. 


UPDATE Property SET Value = 'Newly generated GUID' 
WHERE Property = 'ProductCode' 
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CARD20 (Product Properties) 


CARD20 resolves ACE20, which checks the Upgrade Code to see if it is unique. If the Upgrade Code is not unique, 
ACE20 fails. 


CARD 20 generates a new, unique Upgrade Code to replace the duplicate code. To do this, CARD20 runs the 
following query: 


UPDATE Property SET Value = 'Newly generated GUID' 
WHERE Property = 'UpgradeCode' 
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Command-Line Functionality 


ConflictSolver supports the folowing command-line parameters. These parameters are case-insensitive, and must be 


preceded with either a dash symbol (-) or a forward slash (/). 


If you invoke ConflictSolver using the command line iscmide.exe without passing any parameters, ConflictSolver will 


launch in Ul mode. 


By default, all packages are imported into the root group. If you want to import packages to specific groups, you must 
use a configuration file (C parameter), and specify a group for each package. 


iscmide.exe -? 


Parameter Description 

-? Displays version information and help text for 
ContflictSolver command-line parameters. 

Example: 


-C"configuration_file_name" 


Example: 


iscmide.exe -I -C"C:\MyConfigs\myconfig.ini" 


The name and location of a configuration file (.ini) 
containing any required parameters for import. If you 
are using a configuration file, the only necessary 
parameters to pass at the command line are -l and - 
C"configuration_file_name"; you can include all other 
parameters inside the INI file. 


-D"application_catalog_name" 


Example: 


iscmide.exe -S"mysql\sqlI1" 
-U"admin" -P"admin" 
-D"mycatalog" -IF"c:\mypackages\mymsi.msi; 
c:\mypackages\mytrans.mst;" 


The name of the Application Catalog. 


This parameter is only used for SQL Server Application 
Catalogs, and is a required parameter when using a 
SQL Server—based Application Catalog. 


-F"file_name" 


Example: 

iscmide.exe -F"c:\mycatalogs\conflict.mdb" 
-IF"c:\mypackages\mymsi.msi; 
c:\mypackages\mytrans.mst;" 


The full path and name to the Microsoft Access file 
used as the Application Catalog. If this parameter is 
passed, SQL Server parameters are ignored. 


This parameter is only used for Access Application 
Catalogs, and is a required parameter when using an 
Access-based Application Catalog. 
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Parameter Description 

-l This option indicates that a bulk import operation is to 
be performed. If you are using -IF or -IMM, you do not 

Example: need to specify this, as these parameters inform 


iscmide.exe -I -C"c:\mypackages\myconfig.ini" ConflictSolver to perform an import operation. 


-IF"msi_file_name[; transform1; transform2...]" The name and full path of the MSI file to be imported, 

-IF"msi_file_name[; patch1; patch2...]" and optionally a semicolon-delimited list of transforms 

-IF"msi_file_name[; transform1; patch1; patch2...]" or patches to be applied before importing the 
package. 

Example: 


iscmide.exe -F"c:\mycatalogs\conflict.mdb" 
-IF"c:\mypackages\mymsi.msi; 
c:\mypackages\mytrans.mst;" 


OR 

iscmide.exe -F"c:\mycatalogs\conflict.mdb" 
-IF"c:\mypackages\mymsi.msi; 
c:\mypackages\mypatch.msp; 

c:\mypackages\mytrans.mst;" 


OR 


iscmide.exe -F"c:\mycatalogs\conflict.mdb" 
-IF"c:\mypackages\mymsi .msi 


-IMM"merge_module_file_name" The name and full path of the merge module to be 
imported. 
Example: 


iscmide.exe -F"c:\mycatalogs\conflict.mdb" 
-IMM"c:\mymodules\crystal.msm" 


-INCP Use to specify the Native Channel Packager (NCP) file 
that is to be imported. 
Example: 


iscmide.exe -INCP"C:\Acrobat.ncp" 


-L"logfile_name" The output logfile name. 


Example: 

iscmide.exe -I 
-c"c:\mypackages\myconfig.ini” 
-L"c:\mypackages\mylog. txt" 
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Parameter 


Description 


-P"password" 


Example: 


iscmide.exe -S"mysql\sqI1" 
-U"admin" -P"admin" 
-D"mycatalog" -IF"c:\mypackages\mymsi .msi; 
c:\mypackages\mytrans.mst;" 


The password for the SQL Server Application Catalog. 


This parameter is only used for SQL Server Application 
Catalogs, and is a required parameter when using a 
SQL Server—based Application Catalog. The only 
exception to this requirement is if you want to take 
advantage of AdminStudio's integrated security. In this 
case, do not use the -P parameter. 


-Q 


Example: 


iscmide.exe -Q 


Starts ConflictSolver as a system tray icon application 
without showing the full ConflictSolver Interface. When 
this option is specified with bulk import options, 
ContflictSolver exits once import is complete. 


-S"server_name[\instance_name]" 


Example: 


iscmide.exe -S"mysql\sqI1" 
-U"admin" -P"admin" 
-D"mycatalog" 

-IF"c:\mypackages\mymsi .msi; 
c:\mypackages\mytrans.mst;" 


The SQL Server where the Application Catalog 
resides. If this parameter is passed, the -F parameter is 
ignored. 


This parameter is only used for SQL Server Application 
Catalogs, and is a required parameter when using a 
SQL Server—based Application Catalog. 


-U"login_id" 


Example: 


iscmide.exe -S"mysql\sql1" 
-U"admin" -P"admin" 
-D"mycatalog" 

-IF"c:\mypackages\mymsi .msi; 
c:\mypackages\mytrans.mst;" 


The user name for the SQL Server Application 
Catalog. 


This parameter is only used for SQL Server Application 
Catalogs, and is a required parameter when using a 
SQL Server—based Application Catalog. The only 
exception to this requirement is if you want to take 
advantage of AdminStudio's integrated security. In this 
case, do not use the -U parameter. 
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ConflictSolver Configuration File 


In addition to supporting individual command-line parameters, ConflictSolver can also use a configuration file (when 
specified using the -C"configuration_file_name" parameter). This INI file can contain the values for all required 
parameters during the import process. 


Configuration File Examples 


Configuration File for SQL Server Application Catalog for a Named User 


[General ] 

DatabaseType=SQL 

LogFi le=c:\temp\importlog.txt 
MSIFi le=3 


MSMFi le=1 


[soL] 
Server=ConflictSolverSQL2K 
UserID=Admin 
Password=mypas sword 
Database=AdminStudio50 


[MSIFi le-1] 

Fi le=\\server\Datal.msi 
Transforml=\\server\Datala.mst 
Transform2=\\server\Datalb.mst 
Group=O0f fi ceApps 


[MSIFi le-2] 
Fi le=\\server\Data2.msi 
Group=O0f fi ceApps\Secondary 


[MSIFi le-3] 
Fi le=\\server\Data3.msi 


[MSMF7 le-1] 
File=\\server\CrystalReports.msm 


Configuration File for SQL Server Application Catalog for a Trusted User 


[General ] 

DatabaseType=SQL 

LogFi le=c:\temp\importlog.txt 
MSIFi le=3 

MSMF7i le=1 


[SQL] 
Server=ConflictSolversQL2K 
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Database=Adminstudio050 


[MSIFi le-1] 

Fi le=\\server\Datal.msi 
Transforml=\\server\Datala.mst 
Trans form2=\\server\Datalb.mst 
Group=Of fi ceApps 


[MSIFi le-2] 
Fi le=\\server\Data2.msi 
Group=O0f fi ceApps\Secondary 


[MSIFi le-3] 
Fi le=\\server\Data3.msi 


[MSMFi le-1] 
Fi le=\\server\CrystalReports.msm 


Configuration File for MS Access Application Catalog 


[General ] 

DatabaseType=Access 
LogFile=c:\temp\importlog.txt 
MSIFi le=3 

MSMFi le=1 


[Access] 

DatabaseF7i le=\\Shared\CSDB.mdb 
UserID=Admin 
Password=mypassword 


[MSIFi le-1] 

Fi le=\\server\Datal.msi 
Transforml=\\server\Datala.mst 
Transform2=\\server\Datalb.mst 
Group=O0FfficeApps 


[MSIFi le-2] 
Fi le=\\server\Data2.msi 
Group=O0f fi ceApps\Secondary 


[MSIF le-3] 
Fi le=\\server\Data3.msi 


[MSMF7 le-1] 
File=\\server\CrystalReports.msm 


Configuration File for Applying Transforms and/or Patches During 
Command-Line Import 


[General ] 
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DatabaseType=Access 

LogFi le=c:\temp\importlog.txt 
MSIFi le=3 

MSMFi le=1 

OtherSetupFile=1 


[access] 

DatabaseFi le=\\Shared\CSDB .mdb 
UserID=Admin 
Password=mypassword 


[MSIFi le-1] 

Fi le=\\server\Datal.MST 
Transforml=\\server\Datala.MST 
Transform2=\\server\Datalb.MST 
Patchl=\\server\Datalp.MSP 
Patch2=\\server\Data2p.MSP 

AdminInstal ]Location=\\Server\Shared\Datal 


[MSIFi le-2] 

Fi le=\\server\Data2.MSI 
Patchl=\\server\Datalp.MSP 
AdminiInstal1]Location=\\Server\Shared\Data2 


[MSIFi le-3] 

Fi le=\\server\Data3.MSI 
Transforml=\\server\Data3a.MST 
Patchl=\\server\Datalp.MSP 

AdminInstal 1Location=\\Server\Shared\Data3 


[otherSetupFi le-1] 
SetupName=AdminStudio for Macintosh 
SetupDi rectory=C: \AdminStudio\MacFi les 
Ful 1Directory=1 
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Parameter Description 
DatabaseType You must set this required parameter to either SQL or Access, and include the 
corresponding section later in the INI file. 
LogFile Using this parameter, you can specify the name and location of the output log file, and 
corresponds to the -L command-line parameter. 
MSIFile Use this parameter to indicate the number of MSI files to be imported. Each MSI file is 
denoted in subsequent INI file sections. 
If you are only importing merge modules, you can omit this parameter from your 
configuration file. 
MSMFile Use this optional parameter to indicate the number of merge modules to be imported. Each 
merge module file is denoted in subsequent INI file sections. 
If you are only importing Windows Installer packages, you can omit this parameter from 
your configuration file. 


[SQL] Section 


This section is only necessary when using a SQL Server Application Catalog. 


Parameter Description 

Server Using this required parameter, you can provide the name of the SQL Server. It corresponds 
to the -S command-line parameter. 

UserID Using this parameter, you can provide the login name for the SQL Server. It corresponds to 
the -U command-line parameter. This is required for non-trusted logins. 

Password Using this parameter, you can provide the password for the SQL Server. It corresponds to 
the -P command-line parameter. This is required for non-trusted logins. 

Database Use the Database parameter to provide the login name for the SQL Server. It corresponds 
to the -D command-line parameter. If a value is not specified, the default SQL Server 
Application Catalog for the specified login will be used. 
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Parameter Description 

DatabaseFile The DatabaseFile parameter allows you to specify the name and location of the Access file 
used as ConflictSolver. It corresponds to the -F command-line parameter, and is a required 
parameter. 

UserID Use this optional parameter to provide the login ID for the Access Application Catalog. 

Password Use this optional parameter to provide the password for the Access Application Catalog. 


[MSIFile-n] Section 


Each Windows Installer package to be imported into ConflictSolver must be described in its own section, numbered 
sequentially ([MSIFile-1], [MSIFile-2], etc.). Each section must contain the name and location of the file, and any 
transforms or patches to apply to the file prior to import. 


Parameter Description 

File Using the File parameter, you can specify name and location of the Windows Installer 
package (.msi) you are importing. This parameter is required. 

Transformn Use this parameter to specify the name and location of a transform to apply to the 
Windows Installer package prior to import. Each subsequent transform increases the value 
of n (Transform1, Transform2, Transform3, etc.). 

Patchn Use this parameter to specify the name and location of a patch to apply to the Windows 


Installer package prior to import. Each subsequent patch increases the value of n (Patch1, 
Patch2, Patch3, etc.). 


AdmininstallLocation 


When applying a patch to an MSI package, it is necessary to perform an Administrative 
install of the MSI package and then perform an Administrative install of each patch 
package one by one. Use this parameter to specify the location where the Administrative 
install will be performed. 


Group You can use the Group parameter to specify the group into which the package should be 
imported. Use a "\" to indicate a group hierarchy. If no group is specified, the package is 
imported into the root group. 

SetupName Identifies the name of the imported setup package (an Other Setup Type). 

SetupDirectory Identifies the location of the Other Setup Type setup files. 

FullDirectory Specifies whether to import files in the selected directory and all subdirectories (1) or just 


the files in the selected directory (0). 
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[MSMFile-n] Section 


Each merge module to be imported into ConflictSolver must be described in its own section, numbered sequentially 
[MSMFile-1], [MSMFile-2], etc.). Each section must contain the name and location of the file. 


Parameter Description 
File Use this parameter to specify the name and location of the merge module (.msm) you are 
importing. 


[NCPFile-n] Section 


Each Native Channel Packager (NCP) file to be imported into ConflictSolver must be described in its own section, 
numbered sequentially ([NCPFile-1], [NCPFile-2], etc.). Each section must contain the name and location of the file. 


Parameter Description 
File Use this parameter to specify the name and location of the NCP file (.ncp) you are 
importing. 


Using a Configuration File with ConflictSolver 
Command-Line Options 


ConflictSolver supports use of a configuration file to pass parameters during command-line import. This is extremely 


useful if you are importing multiple packages and/or merge modules simultaneously. Use the following command line 
to use a configuration file: 


iscmide.exe -C"configuration_file_name" 


Replace configuration_file_name with the name and location of the configuration file to use. 
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Applying Transforms and Patches During 
ConflictSolver Command-Line Import 


ConflictSolver provides two mechanisms for applying transforms or patches to a Windows Installer package during 
import. First, if you are only importing a single package into ConflictSolver from the command line, you can pass 
transforms or patches after the file name, as in the following command lines: 


Transform: iscmide.exe -IF"msi_file;[mst1;mst2;]" 
Patch: iscmide.exe -IF"msi_file; [msp1;msp2;]" 
Both: iscmide.exe -IF"msi_file; [mst1;msp1;]" 


Replace msi_file with the name and location of the Windows Installer package, and mst1 and mst2 or msp1 and msp2 
with the names and locations of the transforms or patches to apply. For example, if your MSI file was named 
datal.msi and your two MST files were named alpha.mst and gamma.mst, your command line would look like the 
following: 


iscmide.exe -IF"datal.msi;alpha.mst;gamma.mst; 


. 


Depending on the situation, it may be necessary to pass additional command-line parameters. 


If you are importing multiple Windows Installer packages, and applying transforms or patches to them, use a 
configuration file in which you can specify the names and locations of the packages and associated transforms or 
patches. Use the following command line to use a configuration file: 


iscmide.exe -C"configuration_file_name" 


Replace configuration_file_name with the name and location of the configuration file to use. 


Connecting to a Specific SQL Server Application 
Catalog Using Command-Line Options 


Using the following command line, you can connect to a specific SQL Server Application Catalog: 


iscmide.exe -S"sql_server_name" -U"user_id" -P"password" 


Replace sql_server_name with the specific SQL Server name (including path information). Replace user_id and 
"password" with the UserID and password for the server. 
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Depending on the Application Catalog configuration, it may be necessary to pass additional command-line parameters, 
such as the Application Catalog name. 


Connecting to a Specific Access Application Catalog 
Using Command-Line Options 


Using the following command line, you can connect to a specific Access Application Catalog: 


iscmide.exe -F"mdb_file_name" 


Replace mdb_file_name with the specific Access Application Catalog name (including path information). 


lie 


Depending on the Application Catalog configuration, it may be necessary to pass additional command-line parameters, 
such as UserID, or password. 


Importing Multiple Windows Installer Packages 
Simultaneously into ConflictSolver 


The best way of importing multiple Windows Installer packages simultaneously into ConflictSolver is via a 
configuration file. Use the following command line to call your configuration file, in which you can specify multiple 
Windows Installer packages to import. 


iscmide.exe -C"configuration_file" 


Replace configuration_file with the name and location of the configuration file containing the names and locations of 
the packages you want to import. 


Importing Multiple Merge Modules Simultaneously 
into ConflictSolver 


The best way of importing multiple merge modules simultaneously into ConflictSolver is via a configuration file. Use 
the following command line to call your configuration file, in which you can specify multiple merge modules to 
import. 

iscmide.exe -C"configuration_file" 


Replace configuration_file with the name and location of the configuration file containing the names and locations of 
the merge modules you want to import. 
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Simultaneously Importing Windows Installer 
Packages and Merge Modules 


To simultaneously import both Windows Installer packages and merge modules into your ConflictSolver, use a 
configuration file from the command line. In this configuration file, you can specify the names and locations of both 
merge modules and Windows Installer packages you want to import into ConflictSolver. 


Use the following command-line to specify your configuration file: 


iscmide.exe -C"configuration_file_name" 


Replace configuration_file_name with the name and location of the configuration file to use. 


Using ConflictSolver to Import All Packages in a 
Directory 


It is possible from the ConflictSolver command line to import all packages in a directory. This can be done by placing 
the following line in a batch file (modifying it as necessary for your specific environment): 


for %%a in (*.msi) do ISCMInterface -S"server_name" -U"userid" -P"password" 
-D"Application_Catalog_Name" -IF"%%a" -Q -L"%%aLog.txt" 


The above statement runs ConflictSolver, importing each MSI package in the Application Catalog, and creates a log 
file with the name of the MSI prepended to the log file name. 


However, the above command makes the following assumptions: 


m ISCMInterface.exe is in the path; otherwise, include the full path to ISCMInterface.exe. 


m All packages are being imported into the specified SQL Server Application Catalog (provide the server name, 
userid, password, and Application Catalog name with the appropriate parameters -S,-U,-P, and -D, respectively). 


m The above command will start ConflictSolver, import a file, exit ConflictSolver, and then restart ConflictSolver for 
each MSI file. If this is not acceptable, use a configuration file instead. 


E No transforms are applied to the imported packages. If you need to apply transforms, use a configuration file 
instead. 


m ConflictSolver starts in quiet mode. If it is switched to full mode, it is your responsibility to end the ConflictSolver 
process so the next file can be imported. 


InstallShield Software Corporation © 2004 842 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


Running ConflictSolver Import Silently 


ConflictSolver can be run silently in system tray mode by using the following command line: 


iscmide.exe -Q 


An icon for ConflictSolver, with a corresponding context menu available by right-clicking on the icon, appears in the 
system tray. If you pass the -Q parameter in addition to other parameters, progress is displayed in the tooltip available 
when you mouseover the icon. This is beneficial if you are importing a sizeable amount of packages, yet want to 
monitor the progress periodically. 


In quiet mode, when import from the command line ceases, ConflictSolver automatically exits. 


Creating a Log File During ConflictSolver 
Command-Line Import 


It may be necessary or beneficial to create a log file during package/merge module import from the ConflictSolver 
command line. You may want to see the results of the import, or determine why certain packages were not processed 
as expected. To create a log file, use the following command-line: 


iscmide.exe -L"log_file_name"” 


Replace log_file_name with the name and location of the log file you want to create. 


It may be necessary to pass additional command-line parameters, depending on the task you are performing from the 
command line. 
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Creating Shoricuts to Specific Application Catalogs 


For convenience, you may want to create a Windows shortcut to launch ConflictSolver and automatically connect to a 
specific Application Catalog. 


To create the shortcut: 


1. On the Windows Desktop, right-click, point to New, and select Shortcut. The Create Shortcut Wizard 
appears. 


2. Click the Browse button and navigate to the ConflictSolver executable (ISCMInterface.exe). Typically, it 
is in the Program Files\InstallShield\AdminStudio\Version\ConflictSolver directory. When you have 
located it, click OK and then click Next. 


3. Type a name for the shortcut and click Finish. The new shortcut appears on the Desktop. 
4. Right-click on the shortcut and select Properties. 


5. In the Properties dialog, append the necessary command-line parameters to the end of the target. For 
example, if you want to connect to an Access Application Catalog called AppCat1.mdb located in 
C:\Catalogs, append -F"C:\Catalogs\AppCat] .mdb" to the end of the value in the Target field. 


6. Click OK to dismiss the dialog. 


If you are creating a shortcut to a SQL Server Application Catalog, you need to provide values for the SQL Server 
name, UserID, password, and Application Catalog name using the -S, -U, -P, and -D parameters. 
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ConflictSolver Reference 


ConflictSolver reference includes the same topics displayed when you click a help button from a Wizard or dialog box 
in the ConflictSolver interface. Reference information for ConflictSolver is organized into the following areas: 


ConflictSolver Reference 


ConflictSolver Interface 


€ 


This section contains information about the main ConflictSolver interface, including menus and the toolbar. 


Views 


€ 


Each view available in ConflictSolver is covered in this section. 


Dialogs 


€ 


Specific help for each dialog box in ConflictSolver is covered in this section. 


Wizards 


This section contains a panel-by-panel reference for each Wizard in ConflictSolver. 


€ 


ConflictSolver Interface 


The ConflictSolver user interface consists of three areas: the ConflictSolver Navigation window, the Details pane, and 
the Output window. Both the ConflictSolver Navigation window and the Output window are dockable. 


E Navigation window— The ConflictSolver Navigation window consists of two tabs: the products explorer and 
the merge modules explorer. 


E Details pane—When you select different items in the products explorer or merge modules explorer, the Details 
pane displays corresponding information about that item. 


= Output window—The Output window consists of tabs where output is displayed during different 
ConflictSolver processes. 


ConflictSolver also supports many context menus in addition to the menu bar and toolbar functionality. 
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The following commands and toolbar buttons are available in ConflictSolver. Additionally, several commands can be 
accessed through context menus. 


Menu Command Shortcut Description 

Catalog Connect Ctrl+O Displays the Connect to Application Catalog dialog, where 
you can open an existing Application Catalog. Three types 
are available: a Microsoft Access Application Catalog, a 
Microsoft SQL Server Application Catalog, or the sample 
Application Catalog. When clicking on the toolbar button, 
it corresponds to the Microsoft Access Application Catalog 
command. 

Catalog Refresh Ctrl+R Refreshes the current Product and Merge Module views. 
This is particularly useful if multiple people are working on 
the same Application Catalog. 

Catalog Disconnect Closes the currently open Application Catalog. 

Catalog Remote Link/unlink to one or multiple Application Catalogs. This 

Package Alert allows you to copy packages between various Application 
Catalogs to maintain consistency between the copied 
packages. You can also choose to manually refresh the 
Application Catalog so that it remains consistent with other 
linked Application Catalogs. 

Catalog Merge Alt+S Launches the Merge Wizard, which you can use fo select 
a different Application Catalog and import its contents into 
the current Application Catalog. Conflicts will be reported 
between the packages in ConflictSolver. 

Catalog Import File Ctrl+I Launches the Import Wizard, allowing you to import a 
MSI, MSM, MSP, OSC, or NCP file into ConflictSolver. 
You can also select Other Setup Types to import other non- 
MSI based setups. 

Catalog Delete All Alt+A Purges ConflictSolver of all packages. 

Catalog User Displays the User Properties Dialog, which allows any user 

Properties to view their current roles and permissions in AdminStudio. 

Catalog Recent Connects to the most recently opened Application Catalog. 

(1, 2, 3, 4) 

Catalog Exit Closes ConflictSolver. 

Edit Find Ctrl+F Use to search for data in various tables in the Application 
Catalog. 
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Menu Command Shortcut Button Description 
View Toolbar Alt+0 Toggles the Toolbar. 
View Status Bar Alt+1 Toggles the Status Bar. 
View Project Alt+2 Toggles the Project Workspace. 
Workspace 
View Output Alt+3 Toggles the Output window. 
Window 
Conflicts Validation FA ig Launches the Validation Wizard, which you can use to 
Wizard select any Windows Installer package for validation. The 
output is displayed in the Output window. 
Conflicts Conflict F5 N Launches the Conflict Wizard, through which you can 
Wizard open a Windows Installer package and start comparing it 
against packages in ConflictSolver for conflicts. The output 
is displayed in the Output window. 
Conflicts Stop Stops the validation or conflict search. 
Conflicts Resolve F6 F Displays the Conflict Resolution Dialog, through which you 
External resolve conflicts discovered by ConflictSolver between an 
Package external package and packages already in ConflictSolver. 
Conflicts 
Conflicts Rules Viewer a Displays the Rules Viewer Dialog, from which you can 
create new ACE rules. 
Reports Conflicts Creates the Conflicts report. 
Reports File Search Creates the File Search report. You will be prompted to 
enter the file you want to find. 
Reports Files Creates the Files report. 
Reports Registry Creates the Registry Search report. You will be prompted 
Search for the registry data you want to find. 
Reports Registry Creates the Registry Report. 
Tools Customize Alt+O Opens the Customize Dialog, where you can customize 
toolbar settings. 
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Menu Command Shortcut Description 
Tools Options Alt+N Opens the Options Dialog, where you can change various 
ConflictSolver settings including default conflicts to identify, 
the default location for Windows Installer packages, the 
default Application Catalog, report locations, the default 
validation file, and duplicate package identification 
options. 
Help Contents Launches the online Help Library and displays the Contents 
tab. 
Help Index Launches the online Help Library and displays the Index 
tab. 
Help Search Launches the online Help Library and displays the Search 
tab. 
Help Support Connects to the InstallShield Support Central Web site. 
Central 
Help InstallShield Connects to the InstallShield Community. 
Community 
Help ReadMe Displays the AdminStudio ReadMe file. 
Help Feedback Connects fo an online form, through which you can 
provide feedback about ConflictSolver or AdminStudio. 
Help InstallShield Connects to the InstallShield Web site. 
on the Web 
Help About Displays the About dialog box with version information for 
InstallShield ConflictSolver. 
Conflict Solver 
OS Snapshot Opens the OS Snapshot Information Panel, which allows 
Import you to import an OS snapshot into ConflictSolver. Only 
available from the toolbar or context (right-click) menu. 
Help Library Launches the online Help Library. 
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Products Explorer Icons 


The following icons are used on the products explorer: 


Name Icon Description 
Group (=) A group, which is used to organize your data in ConflictSolver. 
@& A group containing a product with unresolved conflicts. See Resolving Conflicts. 
@Ì A group containing a product linked to a remote application catalog. See Using 
Remote Package Alert to Link to Remote Application Catalogs. 
G&A group containing both a product linked to a remote application catalog and a 
product with unresolved conflicts. See Resolving Conflicts. 
Product A product that has been imported into the ConflictSolver Application Catalog 


database. The product could be an MSI file, an Other Setup Type package, or a 
Marimba NCP File. 


A product with unresolved conflicts. See Resolving Conflicts. 


A product that has an unresolved question with its associated files. One or more 
files, transforms, or patch files associated with a product is either missing from the 
original import directory or its last modified date does not match the last modified 
date stored in the Application Catalog. When this icon is selected, a message 
appears in the Product View identifying the files in question and prompting you to 
take action to resolve the problem. 


A product with unresolved conflicts that also has an unresolved question with its 
associated files. One or more files, transforms, or patch files associated with a 
product is either missing from the original import directory or its last modified date 
does not match the last modified date stored in the Application Catalog. When 
this icon is selected, a message appears in the Product View describing the 
missing files and prompting you to locate the missing files. When this icon is 
selected, a message appears in the Product View identifying the files in question 
and prompting you to take action to resolve the problem. Also, see Resolving 
Conflicts. 


A product linked to a remote application catalog. See Using Remote Package 
Alert to Link to Remote Application Catalogs. 


A linked product in a local Application Catalog that has been updated on the 
Remote Server and needs to be refreshed in order to update its data with the data 
on the Remote Server. See Refreshing a Linked Package. 
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Name Icon Description 
Transforms a] A transform. 

A) A transform that has an unresolved question. It is either missing from the original 
import directory or its last modified date does not match the last modified date 
stored in the Application Catalog. When this icon is selected, a message appears 
in the Product View prompting you to take action to resolve the problem. 

OS Snapshot Wj An OS snapshot, which is a file representing a particular computer system's 
contents. 
Conflicts RW Click to access the product's Conflicts View, where you can access information 


pertaining to the last execution of the Conflict Wizard. 


Extended Attributes 


Click to display the optional Extended Attributes associated with the package. 


Files or 
Files/Components 


Click to display the Files View or the Files and Components View, listing all of the 
files and components in the MSI package, merge module, OS snapshot, or NCP 
file. 


Click to display the Files View or the Files and Components View, listing all of the 
files and components in the MSI package, merge module, OS snapshot, or NCP 
file. The question mark icon indicates that a file is missing from the original import 
directory. When this icon is selected, a message appears in the Files View 
describing the missing files and prompting you to locate the missing files. 


INI File Changes 


Click to display the INI File Changes View, listing any INI file changes made by 
the product. 


Merge Modules 


Click to display any merge modules included the product. 


gle ale wy 


Registry Click to display any registry entries created or changed by the product. 
Shortcuts Click to display any shortcuts created by the product. 
Tables Click to view the data for a given package in the Application Catalog. 
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Merge Modules Explorer Icons 


The following icons are used on the merge modules explorer: 


Name 


Icon 


Description 


Merge Modules 


Indicates both the All Merge Modules view, the root node of the merge modules 
explorer containing a list of all merge modules in ConflictSolver, and an individual 
Merge Module. 


Components Q Select to display any components created or changed by the merge module. 
Dependency a Select to display any dependencies in the merge module. 

Exclusion g Select to display any exclusions in the merge module. 

Files P Select to display any files in the merge module 

Products Select to display any products in ConflictSolver that use the merge module. 
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Context Menus 


ConflictSolver includes several context menus which can be accessed by right-clicking on nodes within the products 
explorer and merge modules explorer. These menus provide specific functionality in relation to what is clicked. 


Groups 


When you right-click on a group in the products explorer, the following commands are available through the context 
menu: 


Command Description 


Import Select one of the following data types to launch the Import Wizard and immediately 
display the panel appropriate to your selection. 


= Msi Package—To import a Windows Installer package with any associated 
transforms. The MSI Source Information Panel appears. 


= Msi Package With Patches—To import a Windows Installer package with 
associated patch package(s) and any associated transforms. The MSI Source 
Information Panel appears. 


a OS Snapshot—To import an OS Snapshot. The OS Snapshot Information Panel 
appears. 


= Marimba NCP File—To import a Marimba NCP File. The Marimba NCP Information 
Panel appears. 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature 


available only with InstallShield AMS 2.0. 


= Other Setup Types—To import an Other Setup Types package. The Other Setup 
Installation Files Panel appears. 


The MSI Package, OS Snapshot, Marimba NCP file, or Other Setup file is included in the 
group that was selected when you made a selection on the context menu. 


New Group Creates a new group within the selected group. 
Rename Allows you to rename the selected group. 
Delete Removes the selected group from ConflictSolver, including any groups, products, or OS 


Snapshots contained within it. 


Conflict Wizard Launches the Conflict Wizard directly to the Target Information Panel. 


Find Select to perform a search for data in the various tables of the Application Catalog. See 
Searching the Application Catalog for more information. 
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Command Description 

Cut Cuts the selected group from ConflictSolver. You can then paste it using the Paste 
command. 

Paste Pastes a cut group from ConflictSolver. 

Properties Displays the Group Properties Dialog. 


MSI Package 


When you right-click on an MSI package in the products explorer, the following commands are available through the 
context menu: 


Command Description 


Import Select one of the following data types to launch the Import Wizard and immediately 
display the panel appropriate to your selection. 


= Msi Package —To import a Windows Installer package with any associated 
transforms. The MSI Source Information Panel appears. 


= Msi Package With Patches—To import a Windows Installer package with 
associated patch package(s) and any associated transforms. The MSI Source 
Information Panel appears. 


= OS Snapshot—To import an OS Snapshot. The OS Snapshot Information Panel 
appears. 


a Marimba NCP File—To import a Marimba NCP File. The Marimba NCP Information 
Panel appears. 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature 


available only with InstallShield AMS 2.0. 


= Other Setup Types—To import an Other Setup Types package. The Other Setup 
Installation Files Panel appears. 


The MSI Package, OS Snapshot, Marimba NCP file, or Other Setup file is included in the 
group that was selected when you made a selection on the context menu. 


Reimport the package Reimports the package from its source location (if known and present). You can also use 
F7 to reimport. 


Conflict Wizard Launches the Conflict Wizard directly to the Target Information Panel. 


Find Select to perform a search for data in the various tables of the Application Catalog. See 
Searching the Application Catalog for more information. 


Cut Cuts the selected package from ConflictSolver. You can use the paste command to paste it 
to a new location. 
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Copy Copies the selected package from ConflictSolver. You can use the paste command to paste 
it to a new location. 


Paste Allows you to paste a package that has been cut or copied. 
Refresh Subscribed Rather than waiting until the next scheduled automatic update is performed, select this 
Package option to manually update a subscribed Publication to match the Publication on the 


Publisher Database Server. 


Delete Select one of the following: 


a Package—Removes the product from the current group. 


= Package from All Groups—Removes the product from all groups and removes it 
from ConflictSolver. 

= All Extended Attributes—Removes all extended attributes from the selected 
package. 

= Persisted Conflict Information—Removes persisted conflict information for the 
selected package. 


Associate with AMS Launches the Associate with AMS Application dialog, from which you can pick a package 
Application in AMS with which to associate the extended attribute data for the selected product. 
(InstallShield AMS 2.0-only 


Reports Select one of the following: 


= Conflicts—Generates the Conflicts report. 


a File Search—Generates the File Search report. You will be prompted for the file you 
want to find. 


= Files—Generates the Files report. 


= Registry Search—Generates the Registry Search report. You will be prompted for 
the registry data you want to find. 


a Registry—Generates the Registry report. 
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Other Setup Types 


When you click on an Other Setup Types package (a package containing non-MSI based setup files) in the products 
explorer, the following commands are available through the context menu: 


Command Description 


Import Select one of the following data types to launch the Import Wizard and immediately 
display the panel appropriate to your selection. 


= Msi Package—To import a Windows Installer package with any associated 
transforms. The MSI Source Information Panel appears. 


= Msi Package With Patches—To import a Windows Installer package with 
associated patch package(s) and any associated transforms. The MSI Source 
Information Panel appears. 

= OS Snapshot—To import an OS Snapshot. The OS Snapshot Information Panel 
appears. 


= Marimba NCP File—To import a Marimba NCP File. The Marimba NCP Information 
Panel appears. 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature 
available only with InstallShield AMS 2.0. 


=a Other Setup Types—To import an Other Setup Types package. The Other Setup 
Installation Files Panel appears. 


The MSI Package, OS Snapshot, Marimba NCP file, or Other Setup file is included in the 
group that was selected when you made a selection on the context menu. 


Cut Cuts the selected package from ConflictSolver. You can use the paste command fo paste it 
to a new location. 


Copy Copies the selected package from ConflictSolver. You can use the paste command to paste 
it to a new location. 


Paste Allows you to paste a package that has been cut or copied. 
Rename Allows you to rename the selected package. 
Delete Select one of the following: 


a Package—Removes the product from the current group. 


= Package from All Groups—Removes the product from all groups and removes it 
from ConflictSolver. 


= All Extended Attributes — Removes all extended attributes from the selected 
package. 
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Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 


AMS 2.0. 


When you click on an Marimba NCP File package in the products explorer, the following commands are available 


through the context menu: 


Command Description 
Import Select one of the following data types to launch the Import Wizard and immediately 
display the panel appropriate to your selection. 
= Msi Package—To import a Windows Installer package with any associated 
transforms. The MSI Source Information Panel appears. 
= Msi Package With Patches—To import a Windows Installer package with 
associated patch package(s) and any associated transforms. The MSI Source 
Information Panel appears. 
= OS Snapshot—To import an OS Snapshot. The OS Snapshot Information Panel 
appears. 
= Marimba NCP File—To import a Marimba NCP File. The Marimba NCP Information 
Panel appears. 
= Other Setup Types—To import an Other Setup Types package. The Other Setup 
Installation Files Panel appears. 
The MSI Package, OS Snapshot, Marimba NCP file, or Other Setup file is included in the 
group that was selected when you made a selection on the context menu. 
Conflict Wizard Launches the Conflict Wizard directly to the Target Information Panel. 
Find Select to perform a search for data in the various tables of the Application Catalog. See 
Searching the Application Catalog for more information. 
Cut Cuts the selected package from ConflictSolver. You can use the paste command fo paste it 
to a new location. 
Copy Copies the selected package from ConflictSolver. You can use the paste command to paste 
it to a new location. 
Paste Allows you to paste a package that has been cut or copied. 
Rename Allows you to rename the selected package. 
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Command Description 


Delete Select one of the following: 


a Package—Removes the product from the current group. 


= Package from All Groups—Removes the product from all groups and removes it 
from ConflictSolver. 

= All Extended Attributes — Removes all extended attributes from the selected 
package. 

= Persisted Conflict Information—Removes persisted conflict information for the 
selected package. 


When you right-click on an OS Snapshot in the products explorer, the following commands are available through the 
context menu: 


Command Description 


Import Select one of the following data types to launch the Import Wizard and immediately 
display the panel appropriate to your selection. 


= Msi Package—To import a Windows Installer package with any associated 
transforms. The MSI Source Information Panel appears. 


= Msi Package With Patches—To import a Windows Installer package with 
associated patch package(s) and any associated transforms. The MSI Source 
Information Panel appears. 

= OS Snapshot—To import an OS Snapshot. The OS Snapshot Information Panel 
appears. 


a Marimba NCP File—To import a Marimba NCP File. The Marimba NCP Information 
Panel appears. 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature 


available only with InstallShield AMS 2.0. 


= Other Setup Types—To import an Other Setup Types package. The Other Setup 
Installation Files Panel appears. 


The MSI Package, OS Snapshot, Marimba NCP file, or Other Setup file is included in the 
group that was selected when you made a selection on the context menu. 


Conflict Wizard Launches the Conflict Wizard directly to the Target Information Panel. 


Find Select to perform a search for data in the various tables of the Application Catalog. See 
Searching the Application Catalog for more information. 


Cut Cuts the selected OS snapshot from ConflictSolver. You can use the paste command to 
paste it to a new location. 
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Command Description 


Copy Copies the selected OS snapshot from ConflictSolver. You can use the paste command to 
paste it to a new location. 


Paste Allows you fo paste an OS snapshot that has been cut or copied. 
Rename Allows you to rename the OS Snapshot. 
Delete Select one of the following: 


= OS Snapshot—Removes the OS Snapshot from the current group. 


= OS Snapshot from All Groups—Removes the OS Snapshot from all groups and 
removes it from ConflictSolver. 

= All Extended Attributes— Removes all extended attributes from the selected OS 
Snapshot. 


= Persisted Conflict Information—Removes persisted conflict information for the 
selected OS Snapshot. 


Merge Modules Node 


When you right-click on the root-level Merge Modules node in the merge modules explorer, the following command 
is available through the context menu: 


Command Description 


Import Merge Module Launches the Import Wizard directly to the MSM Source Information Panel. 


Individual Merge Modules 


When you click on an individual merge module in the merge modules explorer, the following commands are available 
through the context menu: 


Command Description 


Import Merge Module Launches the Import Wizard directly to the MSM Source Information Panel. 


Delete Removes the selected merge module from ContflictSolver. 
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Output Window 


When the Import, Remote Package Alert, Validation, and Conflict Wizards are run, the output messages and results of 
those wizards are displayed in the various tabs of the Output window. 


Tab Description 


Output When the Validation Wizard or Conflict Wizard is run, messages about the validation and conflict 
Tab identification processes are displayed in this tab. When the process is complete, the Errors, Warnings, and 
Info messages (for Validation only) that were generated are listed in a table format in the Validate or Conflicts 


tab. 


!|Conflict identification started on: Monday, January 12, 2004 - 1:41 PM 
_2J|Source conflict identification package: C:\AdminStudio Shared\Paint Shop Pro 7 Anniversary Edition.msi 


Info Checking For components with identical GUIDs installed to different destinations, 

Info Created 2/13/2001. Last Modified 11/15/2003 

Info Checking components with identical GUIDs for new and/or missing files. 

Info Created 2/13/2001, Last Modified 11/15/2003 K] 


| > 
Import A, Validate A, Conflicts A Remote Package Alert A, Search Results 


Import When the Import Wizard is run to import a package into the Application Catalog, messages about the Import 
Tab process are displayed in this tab. 


x! {Import started at: Monday, January 12, 2004 - 4:17 PM... 
_2/|Source package: \\Testengineering\testing\AdminStudio\ConflictSolver\MSI Data\Acrobat Reader 5.0\Adobe Acrobat Reader.msi 
Importing table ‘ActionText’... 
68 records imported into table ‘ActionText', 
Importing table ‘AdminExecuteSequence’... 
8 records imported into table ‘AdminExecuteSequence’. 
Importing table ‘Condition’... 
Importing table ‘AdminUISequence’... 
10 records imported into table 'AdminUISequence’. 


iil | 
Import A, Validate A, Conflicts A, Remote Package Alert A. Search Results 
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Tab 


Description 


Validate 
Tab 


After the Validation Wizard is run to validate a Windows Installer package and any associated transforms 
prior to importing them into ContflictSolver, or when validation is performed during import, all of the Errors, 
Warnings, and Info messages that were generated are listed in table format. Each table row lists an icon to 


indicate whether it is an Error x] Warning A, or Informational message 4 the name of the ICE that 
generated it, and a brief description of what caused it to occur. To sort this list, click on the column heading of 
the column you want to sort by. 


Type Description 


Import A, Validate A Conflicts 


If a row is active, you can double-click on it to view that row's associated table. The Tables View is launched 
and the table and/or table cells that are causing the problem are highlighted in red. If a row is grayed out, it 
indicates that the table cannot be viewed in ConflictSolver (perhaps because it is in an external package). 


Conflicts 
Tab 


After the Conflict Wizard is run to identify conflicts between a Windows Installer package and packages 
already cataloged in ConflictSolver, or if conflicts are checked during import, all of the Errors and Warnings 
that were generated are listed in a table format. 


Description 


Search Results _ 


Each table row lists an icon to indicate whether it is an Error @ or a Warning A the name of the ACE that 
generated it, and a brief description of what caused it to occur. To sort this list, click on the column heading of 
the column you want to sort by. 


If a row is active, you can double-click on it fo view that row's associated table. The Tables View is launched 
and the table and/or table cells that are causing the problem are highlighted in red. If a row is grayed out, it 
indicates that the table cannot be viewed in ConflictSolver (perhaps because it is in an external package). To 
resolve conflicts, see Resolving Conflicts. 
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Tab Description 


Remote When the Remote Package Alert Wizard is run to link to packages in a remote application catalog, messages 
Package about the linking process are displayed in this tab. 
Alert 


Tab 1 |Begin reading package '\\testengineering\Testing\AdminStudio\ConflictSolver\MSI Data\ACEO6\4CEQ6DB\ACEO6DB. msi From the remote a 


Package '\\testengineering\Testing\AdminStudio\ConflictSolyer\MSI Data\ACE06\ACEQ6DB\4CE06DB. msi’ does not exist in the local app 
Import started at; Monday, January 12, 2004 - 4:30 PM... 
Source package: \\testengineering\Testing\AdminStudio\ConflictSolver\MSI Data\ACE06\4CEG6DB\A4CE06DB. msi 
Importing table ‘ActionText’... 
68 records imported into table ‘ActionText’. 


Importing table 'AdminExecuteSequence’... 
8 records imported into table '‘AdminExecuteSequence’. v 


i | > 


Validate A, Conflicts Remote Package Alert Á Search Results / 


Search When Find is used to search for data in Application Catalog tables, the data that is found is displayed in this 
Results tab, in the following format: 
Tab 


17 occurrence(s) of ‘AppSearch' have been found. 
Package Name Package RowID Table RowID Table Name Column Name Column Data 
2 csmsiActionText Action AppSearch 
csmsiActionText Action AppSearch 
csmsiActionText Action AppSearch 
csmsisys Validation Table AppSearch 


Subscription A, Search Results 


If you double click on the this data, ConflictSolver will navigate to the appropriate record in the Tables View, 
and that record will be highlighted in red. 
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Group View 


The Group view is displayed on the right side of ConflictSolver whenever a group is selected in the products explorer. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


| Catalog Edit Yiew Conflicts Reports Tools Help 


= GR Groups 

{© Accounting 
FÈ ACEO6 (v1.00.0000) oes. 
(È ACEOSConflict (v1.00,0000) 
(9) Adobe Acrobat Reader (v5.0) 
FÈ Adobe PageMaker 6.5 (v6.5) 

+) DemoPlayer (v1,00,0000) 

B InstallShield Software Corporation _F 
{£ Marketing 

wG} Nartco_ACEO6 (v1.00.0000) 

+4 Norton Antivirus Corporate Edition (+ 

K-G Orca (v1.50.2600.0000) 

i) PackageForTheWeb 4 (v4.0.0) 
{© Research 

E visual FoxPro ODBC Driver (v1.0.0) 


If you select a group or product in a group, properties for that group or product are displayed in the Group View. 


A Groups 


Group View 
Properties Name 
SOS (accounting 
Adobe PageMaker 6, 
gs FB aceos 
FÈ ACEO6Conflict 
Adobe E] adobe Acrobat Reader 


jb: Adobe PageMaker 6.5 
DemoPlayer 
\\Testengineering\testing\Adminst [3 Installshield Software Corpe 
Data\ Adobe Pagemaker\Adobe (marketing 

C:\AdminStudio (PB Nartco_AcE06 
Shared\HoweTechnology.mdb Norton Antivirus Corporate 
Orca 


None 


Select an item to view its 
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Name 
(accounting 
acen 
FÈ ACEO6Conflict 
(3 Adobe Acrobat Reader 
R Adobe PageMaker 6.5 
F DemoPlayer 


F InstallShield Software Corporation... 


(Marketing 

F artco_ACEO6 

FÈ Norton AntiVirus Corporate Edition 
Orca 

FR PackageForTheweb 4 
(Research 

F visual FoxPro ODBC Driver 


CER 


Description 


Contact: Your local administrator 
Contact: Your local administrator 
Contact CSC for All Support Issue 
None 

Enter comments regarding this ins 
Contact: Your local administrator 


Contact; Your local administrator 
Enter comments regarding this ins 
Contact: Your local administrator 
Contact; Your local administrator 


Enter Comments Here. 


Additionally, if you double-click an item in the Group view, the corresponding item in the products explorer is 


selected. 


You can sort the products by either Name or Description by clicking on the column title. 
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Product Views (MSI Packages) 


When you select a Windows Installer Package (.msi) from the products explorer, details about that product are 
displayed in the right pane of the user interface. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit view Conflicts Reports Tools Help 
F FEEL, Adobe PageMaker 6.5 
& (GR Groups FEB Product view 
£ Accounting Manufacturer Adobe PageMaker 6.5 
a fae 
a AGEOG (7 100,0000) Subscribed Not associated with any subscribed database. 


E GÈ ACEO6Conflict (v1.00.0000) ‘ ki 
(9 Adobe Acrobat Reader (v5.0) Conflict Results | Conflicts last checked on Monday, January 12, 2004. 


Ea Adobe PageMaker 6.5 (v6.5) Package Code {61DDBAAF-C78B-4562-84B1-9B497D256254} 
aE DemoPlayer (v1.00.0000) Product Code {921 1FBD4-145B-4845-B74E-D64939C43257} 


E- Installshield Software Corporation_F Upgrade Code — {7CC86CC3-696B-46D6-98B4-CC2ED192B4DD} 
{£ Marketing 


$ Nartco_ACED6 (v1.00.0000) Language English {United States) 


FÈ Norton Antivirus Corporate Edition (+ File \\Testengineering\testing\... Adobe Pagemaker\Adobe PageMaker 6.5.msi 
=) Orca (v1.50.2600.0000) Imported On Monday, January 12, 2004 - 3:48 PM 


fa PackageForTheWeb 4 (v4.0.0) Original File  —_\\Testengineering\testing\...\Adobe Pagemaker\Adobe PageMaker 6.5.msi 
{© Research 
Visual FoxPro ODBC Driver (v1.0.0) 


Transforms No transforms are associated with this product. 
Patches No patches are associated with this product. 
Groups Only the current group references this product, 


Description | None 


The following information is included: 


Field Description 
Manufacturer The manufacturer of the package. 
Subscribed Database If this package is associated with a subscribed database, the name of that database is 


listed here. If it is not, the following statement appears: 


Not associated with any subscribed database. 


Conflict Results If any persisted conflict data exists, this is a hyperlink to the package's Conflicts view. 
Package Code The globally unique identifier (GUID) for the setup package. 

Product Code A string that uniquely identifies the product. 

Upgrade Code A string used to upgrade the application. The upgrade code for a package groups that 


package into a specific product family. 


Language The language of this package. 


File This can be either a hard-coded path or a UNC path. 
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Field Description 
Original File For patches, this is the original MSI package against which patch packages were applied 
to get to the final imported MSI package. 
Imported On The date and time the package was imported. 
Transforms This can be either a hard-coded path or a UNC path. 
Patches The patch files that were used to get to the final imported MSI package. 
Groups Any groups to which the package belongs. 
Description You can edit this with additional information about the product. 
aN 


~ 
(4 }— 
U f 


A 


If the package and/or transforms are no longer in their original import directory, you can locate the file(s) from the 
provided hyperlink. You are also informed if the last modified date for the package in ConflictSolver does not match the 
last modified date of the package in its external location. You are given the opportunity to reimport the package to 
keep it synchronized in ConflictSolver. 


If you expand a product, you can view its constituent views: 


Conflicts View 

Extended Attributes View 
Files/Components View 
INI File Changes View 
Merge Modules View 
Registry View 

Shortcuts View 

Tables View 


Conflicts View 


Each product contains a Conflicts view, where you can access information pertaining to the last execution of the 
Conflict Wizard. This persisted conflict data allows you to view when the last execution was performed, the products 
that it was run against, the ACE rules used, and conflicts discovered. The view also provides a list of updated, deleted, 
or added products that may necessitate performing conflict identification again. 
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Summary Information 


The main area of this view displays summary information for the last conflict identification execution. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit Yiew Conflicts Reports Tools Help 


. PackageForTheWeb 4 
E GR Groups N| Conflict view 


cos Conflict Information A/c) 
-G InstallShield Software Corporation_F Conflict Information RIMM — 


{© Marketing Summary 
+) Orca (v1,50,2600,.0000) i 
= R PackageForTheWeb 4 (v4.0.0) When conflict identification was performed on 'PackageForTheweb 4 on 'Monday, January 12, 2004 - 12:41 
` T CERES PM', a total of 3 conflicts) were identified, of which 3 are automatically resolvable, by checking a total of: 


EÀ Extended Attributes 


; Files!Components Lproduct(s), 


INI File Changes using 25 ACE rule(s}. 


Merge Modules None of these product(s) have been updated. 


Ef Registry None of these product(s) have been deleted. 
E Shortcuts No new product(s) have been added to the AdminStudio Application Catalog. 


on leg Resolution Options 
Researc 


The conflict resolution options For this package are to: 
Resolve Conflicts: Save the resolutions within a transform file. 
C:\AdminStudio Shared\PackageForThe Web 41.mst 


You can modify these resolution options by selecting ‘Edit’, 


 — iii 


Products $ Merge Modules 


This information includes: 


m The name of the product on which conflict m The ACE rules used during conflict identification. 


idenuitcalion was pariotine®: m The number of checked packages that have 


m The date and time of the last conflict identification. changed since conflict identification. 
m The number of conflicts detected. m The number of checked packages that have been 
deleted from ConflictSolver since conflict 


m The number of detected conflicts which can be ; f f 
. identification. 
resolved automatically. 
m The number of packages that have been imported 


m The products the current product was checked : 3 ‘ ae : : 
P P into ConflictSolver since conflict identification. 


against. 


Links 


When you click on one of the informational links, the Conflict Information Dialog appears, displaying information on 
the selected link. For example, if you click on the ACE rule link, the Conflict Information dialog appears with the 
ACE Rules tab selected. 


Run Again and Reimport Buttons 


Click Run Again to perform conflict identification on the package again, using the specified packages (if they still exist 
in ConflictSolver) and ACE rules. Because packages may have been removed or modified, conflict identification may 
return different results. Click Reimport to import the package into ConflictSolver again. This is usually done if you 
have already modified the package, and need to run conflict identification again. 
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Conflict Information 


Using the pull-down list at the top of the view, you can toggle between summary information and conflict-specific 
information. When you select a specific conflict type, the view changes to display a list of corresponding errors in the 
product, grouped by ACE. 


testlabsq|2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


a = ‘orTheWeb 4 
= (Gs Groups Flict View 


A aha Confict Informatio 
a InstallShield Software Corporation F Conflict Information Product Properties v 


{© Marketing Conflict Details 
E Orca (v1,50,2600,0000) g A 


=} R PackageForTheweb 4 (v4.0.0) 
Conflicts 
D Extended Attributes ja ® a 
$ ie} D The product code '{(C9COAF10-7B04-449E-9FAC-5436D2E238EC}' is the same in 1 other package(s). 


G Mecane = N ACE20 


E] The package code '{SE6C9285-00E1-4547-4B97-C2577E0A8F7 1}' is the same in 1 other package(s). 


a To aw D The upgrade code '{85447049-4809-495E-BC94-7DF40EBBSE82}' is the same in 1 other packages). 
erge Modules 


Ef Registry 

E Shortcuts 

Tables 
{£ Research 


The icon displayed next to the conflict indicates its status: 


Icon Status 


ə Resolvable 


iv) Resolved 


(x Unresolvable 


In many cases, these errors can be resolved by clicking either Resolve or Resolve All. In cases where no automatic 


resolution is possible, the Unresolvable *# icon appears next to the conflict and the Resolve button is disabled. 


If one of the following options on the Resolution tab of the Options dialog is selected, you several additional dialogs 
could appear prompting for approval or additional information for user input: 


m Ifthe Preview and approve all resolutions option is selected, the Resolution Details Dialog appears, listing 
the changes that are going to be made and prompting you to approve them. 


m Ifthe Maximize user flexibility in selecting resolutions option is selected, and if you are using a CARD 
with multiple resolution options, a list of options from you to choose from could appear the CARD Resolution 
Options Dialog, prompting you to select one. 


For File Conflicts, click the plus sign next to the conflict icon to see the package that conflicts with the selected 
package. 
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Conflict Details 
= X 
= The file ‘Inetwh32.dll’, version '1,10.1.1', in the component 'SystemHelpFiles 
PackageForTheWeb 4 v4.0.0 
BS Ace23 
=| ®@ The file ‘Inetwh32.dll’, size '48640' bytes, version '1,10.1.1', language 'Englis 
PackageForThewWeb 4 v4.0.0 


Resolution Options 


12 Identifying and Resolving Application Conflicts 


This section displays the current resolution option: either resolve in the original Windows Installer package, or using 
the specified transform. Click Edit to change the current settings on the Resolution Options Dialog. 


Extended Attributes View 


The Extended Attributes view, accessible from the Extended Attributes node for each package in ConflictSolver, 


displays the optional extended attributes associated with the package. 


HoweTechnology.mdb - InstallShield ConflictSolver 


|| Catalog Edit Yiew Conflicts Reports Tools Help 


InstallShield AdminStudio 


Ee Extended Attributes \ 


= (Ge Groups 


E R ACE06Conflict (v1.00.0000) 
H G ACETests 
H- Adobe 
=) DemoPlayer (¥1,00,0000) 
S-E InstallShield AdminStudio (v5.01) 
Fh Conflicts 
amg extended Attributes 
Files/Components 
INI File Changes 
Merge Modules 
Registry 
Shortcuts 
Tables 
McAfee VirusScan (v4.5.0) 
 Nartco_ACEO6 Two (v1.00,0000) 
© nep 
OmniPage Pro 10,0 (v10.0.0.0) 
8) PackageForTheWeb 4 (v4.0.0) 
PackageForTheWeb 4 (v4.0.0) 
{© Patch 
RegistryDiff 
{© Subscribed 
Symantec Act! (v4.0.0) 
{© Transforms 
H-H) WindowsXP 


&)---) 


(E7 
p3] 
Œ 
GH) 
E3] 
a 
Œ 


Products k4 Merge Modules 


Application Name 
Application 
Description 

Application Type 


Application vendor 
Version Number 


Current Status 
Business Criticality 


Instructions 
Repackaging 
Requirements 
Hardware 
Requirements 
Software 

isi 


Access 
Requirements 


Division! 
Department 
Business Owner 
Repackaging 
Owner 
Integration Owner 


Licensing 
Agreement 
Support 
Agreement 
Additional 
Documentation 
Repackaging Lo 


Validation Log 


InstallShield Software Corporation © 2004 


InstallShield AdminStudio 
Application preparation and management software for the enterprise 


Management 
5.01 


Requested 
Business Critical 


AdminStudioSInstallGuide.doc 

AdminStudioSRepackagingReg. doc 

Pentium III 500 MHz+, 256+ MB RAM (512 MB preferred), 1.1 GB disk space 
Windows 98, Windows Me, Windows NT 4.0 with Service Pack 6 installed, 
Windows 2000, Windows XP, or Windows Server 2003 with Internet Explorer 
Administrative privileges on the system needed 


Engineering 


Paul Jackson 
Ted Taylor 


Olivia Singh 

Ben Columbo 

15 
Licensing4greement. doc 


SupportAqreement.doc 


Repackaging Log. txt 
Y¥alidation Log. txt 
AdminStudioTestScript.doc 
AdminStudioTestResults.doc 
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These attributes are dynamically populated based on an external extended attribute description file (in XML format). 
You can specify the name and location of this file from the Extended Attributes tab of the Options dialog box. 


On the left side of the view, the name for each attribute is displayed; the right side displays the value for the attribute. 
These values are in read-only fields, from which you can highlight and copy text, or, in the case of file links, launch 
the linked file. The file location displayed represents the location from which the file was originally imported; the file 
is actually stored within the Application Catalog and extracted into a temp directory when you click on the file link. 
This temp directory is purged when ConflictSolver closes, as long as the file is not locked by another application or 
process. 


If you click on the attribute name, you can either provide the value in the Extended Attribute Property Dialog (for 
Text attributes) or browse for a file in a Browse dialog (for File attributes). 


Files/Components View 


When you expand a product in the products explorer, you can click on Files/Components to display the files and 
components in the product. 
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| Catalog Edit View Conflicts Reports Tools Help 


PackageForTheWeb 4 4.0.0 
Files/Components view 


Š Adobe PageMaker 6.5 (v6.5) 
GĦ DemoPlayer (v1.00.0000) 


D-E 


Component FileName FileSize Version Path 


G InstallShield Software Corporatio 
{© Marketing 
Nartco_ACEO6 (v1.00,0000) 
Norton Antivirus Corporate Editic 
f=) Orca (v1,50,2600,0000) 
a R PackageForTheweb 4 (v4.0.0) 
B Conflicts 
@ Extended Attributes 
Files/Components 
INI File Changes 
Merge Modules 
BY Registry 
E Shortcuts 
a Tables 
{£ Research 
=... 5an. = 


JUL 


D-E H 


D-E 


chktrust.exe 

Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 
Folder_Languages 


Folder_Languages 
inetinh?? All 


chktrust.exe 

Hungar- 1. plF| Hungarian. plf 
Indone~1.plf|Indonesian. plf 
Italian. plf 

Japanese. plF 

Korean. plF 
Norweg~1.plF|Norwegian. pif 
Polish. plf 


Portug~1.plF|Portuguese-Braz... 


Portug~2. plF|Portuguese. plF 
Russian. pif 
Slovak. plf 
Sloven~1.plF|Slovenian. plf 
Spanish. pif 
Swedish. plF 
Thai. plf 
Turkish. plF 
inetiaih?? ll 

Uh 


15632 
5200 


5.131.1877.1 


70133 


ProgramFilesFolder 
ProgramFilesFolder 
ProgramFilesFolder' 
ProgramFilesFolder' 
ProgramFilesFolder' 
ProgramFilesFolder' 
ProgramFilesFolder’ 
ProgramFilesFolder 
ProgramFilesFolder' 
ProgramFilesFolder' 
ProgramFilesFolder 
ProgramFilesFolder’ 
ProgramFilesFolder' 
ProgramFilesFolder' 
ProgramFilesFolder 
ProgramFilesFolder' 
ProgramFilesFolder' 
SvetemFolder 


The following information is displayed: 


> 
2i 
E 


Column Description 

Component Name of component that the file listed in the FileName column is associated with. 
FileName Name of file. 

FileSize Size of the file listed in the FileName column. 

Version Version of the file listed in the FileName column. 

Path Installation location of the file listed in the FileName column. 
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You can sort by any column by clicking the appropriate column title. 


INI File Changes View 


When you expand a product in the products explorer, you can click on INI File Changes to display any INI file 
changes made by the product. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


| Catalog Edit Yiew Conflicts Reports Tools Help 


a Adobe PageMaker 6.5 6.5 | 


INI File Changes View 


= (Gg Groups 
{© Accounting 


Component FileName — DirProperty Section Key Value 


_ 6: 
t as ppl MER ie 0000) PM65.EXE  KPCMS.INI WindowsFolder KEPS Precision DRIVE "c:" 
oo OTCE SN PM65.EXE  KPCMS.INI WindowsFolder API PT_DIR  \KPCMS\DCPDE 


w- Adobe Acrobat Reader (v5.0) PM6S.EXE  KPCMS.INI WindowsFolder API CFG_FILE "KPPrefs.cfg" 
S- Adobe PageMaker 6.5 (v6.5) PM6S.EXE  KPCMS.INI WindowsFolder KCP CP_DIR \KPCMS\CMSCP 
i) Conflicts PM65,EXE KPCMS.INI ‘WindowsFolder KCP CTE_NAME " 
@ Extended Attributes 


Files}Components 
Merge Modules 
Registry 
E Shortcuts 
Tables 
E-G] DemoPlayer (v1.00.0000) 
j InstallShield Software Corporatio 
{© Marketing 


The following information is displayed: 


Column Description 

Component Name of component that makes an entry in the INI File. 

FileName Name of INI File that the component listed in the Component column makes an entry in. 
DirProperty The directory location where the INI File will be installed. 

Section The section of the INI file where this entry is made. 

Key The Key used in the INI File entry 

Value The Value used in the INI File entry. 


You can sort by any column by clicking the appropriate column title. 
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Merge Modules View 


When you expand a product in the products explorer, you can click on Merge Modules to display any merge modules 
included the product. 


DER) 
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|| Catalog Edit View Conflicts Reports Tools Help 


Adobe PageMaker 6.5 6.5 


=) & Groups Merge Module: iy 


{© Accounting 
af ACES (v1.00,0000) 
$ ACEC6Conflict (v1.00.0000) 
7#] Adobe Acrobat Reader (v5.0) 
È Adobe PageMaker 6.5 (v6.5) 
5% Conflicts 
Ef Extended Attributes 
Files}Components 
INI File Changes 
Merge Modules 
Ef Registry 
E Shortcuts 
Tables 
m E DemoPlayer (v1.00,0000) 
iE} Fe] InstallShield Software Corporatio 
{© Marketing 


ModuleID 


pedlib32.467717E9_4C97_4D36_9... 
mfc30,.566D0194_78B8_4FB5_86F... 
COMCAT,3207D1B0_80E5_11D2_... 
MSYCRT.S1D569E0_8428_11D2_B... 
OLEAUT32.8COC5940_7DC8_11D... 
MFC42,51D569E2_8428_11D2_B9... 
MSSTKPRP, 7EBEDD3E_4466_11D.., 
MFCANS32.B670087E_C45E_4488... 
MSY¥CP50,06F4171C_7D8E_449D.,.. 
MSVYCRT10,3B9C3DB1_CDE6_454... 
MFCO30,F5510409_E307_4473_B... 
MFCUIA32,.FBD34F7D_9644_40D.., 
URLCACHE.64EACC9B_2464_44F.., 
WOSFIBER.94BB0925_667E_47CB... 
AdobePageMaker_color,0E11DFEC... 
kpcp32,4921E348_EE72_4DE6_B8... 
kpsys32.780ABFA2_7B84_4D06_9.., 


Version 


4,71,1460,1 
6,0.8797.0 
2.40.4275.1 
6,0,8665,.0 
6.0.81.69 


Language 


i {PR Nartco_ACEN6 (v1 .00.0000) pFpick.845D214C_86CE_4FD4_B0.., 


PTPICK32, 1B57FB73_FAED_4B34_... 


erenfO? ACNCEDAI CNAE ADEA D 


-A-E -E-I -E-E-i-E-f-E-L-E-E-E-P-g-E-5-8-] 


The following information is displayed: 


Column Description 

Title The title of the Merge Module included with this package. 

ModulelD The number which uniquely identifies the Module listed in the Title column. 
Version The version of the Merge Module listed in the Title column. 

Language The language that the Merge Module listed in the Title column was written for. 


You can sort by any column by clicking the appropriate column title. 
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Registry View 


When you expand a product in the products explorer, you can click on Registry to display any registry entries created 
or changed by the product. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver DER) 


| Catalog Edit View Conflicts Reports Tools Help 


nf Adobe Pag 
= G Groups Registry View 
fea ee Component Root Key 
S fv aa ) TABLE30.EXE CLSIDH60CED040-7835-1 1cf-8D64-000021508639 In 
Be ACEO6Conflict (v1.00.0000) TABLE30.EXE CLSID\{60CED040-7835-1 1cf-8D64-000021508639}\Iny 
Adobe Acrobat Reader (v5.0) TABLE30.EXE CLSID\{60CEDO40-7835-1 1cF-8D64-000021508639}1Int 
= R Adobe PageMaker 6.5 (v6.5) TABLE30.EXE CLSIDH60CED040-7835-1 1cf-8D64-000021508639 Ini 
i) Conflicts TABLESO.EXE CLSID\{60CED040-7835-1 1cf-8D64-000021508639}\Ins 
E Extended Attributes TABLE3O,EXE CLSID}{60CEDO40-7835-1 Lcf-8D64-000021508639}\Ins 
Files!Components TABLE3O.EXE CLSID\{60CED040-7835-1 1cf-8D64-000021508639}\Mi: 
INI File Changes TABLESO.EXE CLSID\{60CED040-7835-1 1cf-8D64-000021508639}\Mis 
RegistryData_Machine SOFTWARE\Adobe\Media Browser 
Merge Modules RegistryData_Machine SOFTWARE\Adobe\ Media Browser 
a Registry RegistryData_Machine SOFTWARE\Adobe\Media Browser 
E Shortcuts RegistryData_Machine SOFTWARE\Adobe\Media Browser 
Tables RegistryData_Machine SOFTWARE\AdobelPageMaker65\USENGLSH\Imports-O: 
wa Fea] DemoPlayer (v1.00,0000) RegistryData_Machine SOFTWARE\Adobe\PageMaker65\USENGLSH\PageMake 
w Fz] InstallShield Software Corporatio RegistryData_Machine SOFTWARE Adobe\PageMakeróS\USENGLSH\PageMake 
© Marketing RegistryData_Machine SOFTWARE\AdobelPageMaker65\USENGLSH\PageMake 
kI r= Nattco_ACEO6 (v1.00.0000) RegistryData_Machine SOFTWARE\Adobe\lPageMaker65\USENGLSH\PageMake 
a a Ti co | PBG RegistryData_Machine SOFTWARE \AdobelPageMaker65\USENGLSH\PageMake 
JL 


7 rodus at 


IN NNNNNNYNNNOTCCCCCCO 


The following information is displayed: 


Column Description 

Component The name of the component that is creating a Registry entry. 
Root Default value of Key. 

Key Key of the Registry Entry that this component is making. 
Name Name of the Registry Entry that this component is making. 
Value Value of the Registry Entry that this component is making. 


You can sort by any column by clicking the appropriate column title. 
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Shortcuts View 


When you expand a product in the products explorer, you can click on Shortcuts to display any shortcuts created by 
the product. 
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|| Catalog Edit View Conflicts Reports Tools Help 


| Fa Adobe PageMaker 6.5 6.5 
= G Groups \ Shortcuts view 


{© Accounting 


B ACED6 (v1,00.0000) Component Name Directory_ Target 
eS ACEOEC fl i (v1.00.0000}) Folder_qrkconv14 QUARKX~1|QuarkxPress Converter... Dir 164 NewFeature 
E chi bait PIMES.EXE ADOBEP~1 |Adobe PageMaker 6.5 Dirlé¢  NewFeature 
G8] Adobe Acrobat Reader (v5.0) AdobeReg32.exe  REGIST~1|Register PageMaker 6.5 Dir164 NewFeature 
G B Adobe PageMaker 6.5 (v6.5) DEAPP.EXE DICTIO~1|Dictionary Editor Dir164 NewFeature 
RQ Conflicts MS5PCony.exe MICROS~1|Microsoft Publisher to PM... Dir164 NewFeature 
@ Extended Attributes QxConyvrt.exe QUARKX~1|QuarkxPress to PM6.5 C... Dirl64 NewFeature 
Files/Components TABLE30.EXE ADOBET~1|Adobe Table 3.0 Dir164 NewFeature ; 
INI File Changes ShortcutsComponent PAGEMA~1|PageMaker 6.5 Readme Dir164 [SystemFolder ]\write 


Merge Modules 

Ef Registry 

E Shortcuts 

E] Tables 
PY DemoPlayer (v1.00,.0000) 
E7] InstallShield Software Corporatio 

{© Marketing 

Ea A Nartco_4CE06 (v1.00.0000) 


The following information is displayed: 


Column Description 

Component Name of the component that the shortcut listed in the Name column is associated with. 
Name Name of the shortcut. 

Directory_ Directory where the shortcut will exist. 

Target Directory and executable that the shortcut invokes. 


You can sort by any column by clicking the appropriate column title. 
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Tables View 


The Tables view provides a way to view the data for a given package in the Application Catalog. Select the specific 
table you want to view from the Tables list at the top of the view. 
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|| Catalog Edit View Conflicts Reports Tools Help 


Adobe PageMaker 6.5 6.5 
= Ge Groups A fan Tables 


{©} Accounting T — 
@ ACEO6 (v1.00,0000) Tables — fesmsiRadioButton v 


_ z 
GH "GB ACEDSConflict (v1.00.0000) RowID PkgRowID_ Property Order value 
a-i Adobe Acrobat Reader (v5.0) 


= re Adobe PageMaker 6.5 (v6.5) 
R Conflicts 
@ Extended Attributes 
|_] Files/Components 
INI File Changes 
Merge Modules 
w Registry 
Shortcuts 
Tables 
a E DemoPlayer (v1.00.0000) 
E>) InstallShield Software Corporatio 
{© Marketing 
wF] Nartco_ACE06 (v1.00.0000) 
< | 


Products $ Merge Modules 


Y width Height 


x 
AgreeToLicense No 0 
AgreeToLicense Yes 0 
_IsSetupTypeMin Typical 0 
_IsSetupTypeMin Custom 0 

0 
0 
0 
1 
1 


1 1 
2 0 
1 0 
2 6 
_IsMaintenance 1 Change 
2 
3 
1 
2 


0 
_IsMaintenance Reinstall 
_IsMaintenance Remove 


ApplicationUsers AllUsers 
ApplicationUsers OnlyCurrentUser 


6 
6 
6 
6 
6 
6 
6 
6 
6 


Most tables are derived directly from standard MSI tables, as described in the Windows Installer SDK online help. 


When building your own ACE rules to use for conflict identification, it is important to understand the data available 
for packages so you can construct the necessary rule. 


You can sort by any column by clicking the appropriate column title. 


Merge Module Views 
From the Merge Modules tab, you can access the following views: 


= All Merge Modules View—Select this option to view a list of all of the Merge Modules in your catalog. 


m Merge Module View—Select an individual Merge Module to see detailed information on that module. 


All Merge Modules View 


The All Merge Modules view is the root node of the merge modules explorer. It contains a list of all merge modules in 
ConflictSolver, including titles, versions, languages, and identifiers for each module. 
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testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit View Conflicts Reports Tools Help 
r All Merge Modules al 
Merge Modules Merge Module View 
E $ Crystal Reports - ODBC - Oracle Title Version Language Identifier 


b4 Crystal Reports - ODBC - Oracle 1.0 English (United States) CrystalReports_ODBC 
$ SQL Agent Core FilesMerge... 1.0 English (United States} SQLAGENT.C4D32C8: 


a SQL Agent Core Files Merge Modi 


< iil 
Products b4 Merge Modules 


Double-click on a merge module to see information about it in the Merge Module View. 


You can sort by any column by clicking the appropriate column title. 


Merge Module View 


When you select a merge module in the merge modules explorer, details are displayed in this view. 
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| Catalog Edit Yiew Conflicts Reports Tools Help 


à SQL Agent Core Files Merge Module a] 


Merge Modules Merge Module View 
E>} Crystal Reports - ODB Version 1.0 
B L Agent Core 


Language English (United States) 


Components 
Dependency Identifier SQLAGENT.C4D32C83_C28D_4329_4829_31C4C6034F59 


© Exclusion File \\Testengineering\testing\,..\ConflictSolver\MSM Datat SQLAGENT.MSM 
a Files Imported On Monday, January 12, 2004 - 4:57 PM 
= 


= Products 


< Mi 
Products $ Merge Modules 
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These details include: 


Field Description 

Version The version of the Merge Module. 

Language The language that the Merge Module was written for. 

Identifier String that uniquely identifies the Merge Module. 

File The path and file name of the Merge Module file that was imported. 
Imported On The date and time the Merge Module was imported. 


Click the plus sign next to the Merge Module to view these Merge Module constituent views: 


Components 
Dependency 
Exclusion 
Files 
Products 


Components View 


When you expand a merge module in the merge modules explorer, you can click on Components to display any 
components created or changed by the merge module. 
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| Catalog Edit View Conflicts Reports Tools Help 


= SEIS i E SQL Agent Core Files Merge Module 
Merge Modules Components view 


pa $ Crystal Reports - ODBC - Oracle Component ComponentId Directory _ 


E- SQL Agent Core Files Merge Mod} [°c ent can32CB3_C28D_ 4329... {BF60FF69-6CC1-480D-... SqlinstanceBin.c4D32C8: 

p Components SqlågentI1.C4D32C83_C28D_432... {15511886-F576-44BF-...  SqlInstanceBin. C4D32C8: 

Dependency SqlAgentI2,C4D32C83_C28D_432... {6D95A93F-E7AC-4021-,.,  SqlInstanceBin.C4D32C8: 

Q Exclusion SqlAgentI3.C4D32C83_C28D_432... {1BBA0935-0FF8-4F97-...  SqlInstanceBin.C4D32C8: 

Files SqlAgentI4.C4D32C83_C28D_432... {41F5173C-3922-49C8-,,,  SqlInstanceBin.C4D32C8: 

E Products SqlAgentIS.C4D32C83_C28D_432,., {CBA644CA-3B40-4C8E-... SqlInstanceBin.C4D32C8: 

SqlAgentI6.C4D32C83_C28D_432... {435CCC5D-54E6-4D77-... SqlInstanceBin.C4D32C8: 

SqlAgentI?.C4D32C83_C28D_432,., {F414F727-2F94-4670-...  SqlInstanceBin.C4D32C8. 

SqlAgentI8.C4D32C83_C28D_432,., {51266DA5-7168-44BC-...  SqlInstanceBin.C4D32C8. 

SqlAgentI9.C4D32C83_C28D_432,., {4E30E3D3-9DD1-4F8B-...  SqlInstanceBin.C4D32C8: 

SqlAgentI10.C4D32C83_C280_43... {EED20533-57C1-42D7-...  SqlInstanceBin.C4D32C8: 

SqlAgentI11.C4D32C83_C28D_43... {5438D9C9-3F6E-420B-...  SqllnstanceBin, C4D32C8, 

SqlAgentI12.C4D32C83_C28D_43... {A6D63B9A-CF9D-4484-... SqlInstanceBin.C4D32C8:. 

SqlAgentI13.C4D32C83_C28D_43... {5C177ECC-62AA-4B4E-... SqlInstanceBin.C4D32C8. 

‘ m j SqlAgentl14.C4D32C83_C28D_43,., {0B64DD9B-FC58-4B6A-...  SqlInstanceBin.C4D32C8: 
Z o SqlAgentl15.C4D32C83_C28D_43... {4FDB5ABF-F9DF-4836-...  SqllnstanceBin, C4D32C8 

[E Products b Merge Modules “ii a — =) dú w 


The following information is displayed for each component included in this merge module: 


Component 
Componentld 
Directory_ 
csFullPath 
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Dependency View 


When you expand a merge module in the merge modules explorer, you can click on Dependency to display any 
dependencies in the merge module. 


testlabsql2k (HowePublisher2004) - sa - InstallShield ConflictSolver DER) 


| Catalog Edit Yiew Conflicts Reports Tools Help 


SQL Agent Core Files Merge Module al 


Merge Modules y view 


Crystal Reports - ODIE -Orace ModuleLang... RequiredID RequiredLanguage 9 Required¥ersion 
SQL Agent Core Files Merge Modi 


0 SQLAGENT1033,.BF65483,.. 0 
p Components 


0 SQLBASE.2D02443E_700... 0 


Dependency 
Q Exclusion 


Files 
A Products 


< ji 
Products Merge Modules 


The following information is displayed for each dependency included in this merge module: 


ModuleLanguage 
RequitedID 
RequiredLanguage< 
RequiredVersion 


Exclusion View 


When you expand a merge module in the merge modules explorer, you can click on Exclusion to display any 
exclusions in the merge module. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


| Catalog Edit Yiew Conflicts Reports Tools Help 


SQL Agent Core Files Merge Module l 
Merge Modules Exclusion View 
ATL Module for Windows 
Crystal Reports - ODBC - Oracle 
SQL Agent Core Files Merge Modi 
2 Components 
Dependency 


Eson 


_ ModuleLanguage | ExcludedID  ExcludedLanguage = ExcludedMaxVersion § ExcludedMinVersion 
No records found. 


Files 
l=) Products 


SQL Server Core Files Merge Mod 
SQL Server Tools Core Files Merg 
VBScriptRuntime 


Products b] Merge Modules 
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The following information is displayed for each exclusion included in this merge module: 


ModuleLanguage 
ExcludedID 
ExcludedLanguage 
ExcludedMaxVersion 
ExcludedMinVersion 


Files View 


When you expand a merge module in the merge modules explorer, you can click on Files to display any files in the 
merge module. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit Yiew Conflicts Reports Tools Help 


xx! SQL Agent Core Files Merge Module + 


Merge Modules Fil y 
®© Crystal Reports - ODBC - Oracle 
SQL Agent Core Files Merge Modi 


Component_ il FileName FileSize Version 
Sql4gent.Cc4D32C83.., sqlagent.EXE.C4D3... sqlagent.EXE 303680 2000.80.534.00 

p Components Profiler.C4D32C83_...  PFCLNT80.dll.C4D3... PFCLNT80.dl 414272 2000.80.534.00 
Dependency Sqlågent.C4D32C83... SQLAGENT.dll.C4D... SQLAGENT.dll 28672 2000.80.534.00 
Q Exclusion SqlAgent.C4D32C83... sqlatxss.DLL.C4D3... sqlatxss.DLL 45632 2000.80.534.00 
a Files Sqlågent.C4D32C83... sqlcmdss.DLL.C4D3,.. sqlcmdss.DLL 53824 2000.80.534.00 


=) 


l=) Products SqlA4gent.C4D32C83,,. sqlrepss.DLL.C4D3..,_ sqlrepss.DLL 33344  2000,80,534,00 


The following information is displayed: 


Column Description 

Component_ Name of component that this Merge Module file is associated with. 
File Name of this Merge Module file. 

FileName File name of this Merge Module file. 

FileSize Size of this Merge Module file. 

Version Version of this Merge Module file. 
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Products View 


When you expand a merge module in the merge modules explorer, you can click on Products to display any products 
in ConflictSolver that use the merge module. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit View Conflicts Reports Tools Help 


xl FEEL, SQL Agent Core Files Merge Module g 
Merge Modules Products View 
+ } ATL Module for Windows 


ProductName ProductVersion Manufacturer 


Crystal Reports - ODBC - Oracle No records found. 


SQL Agent Core Files Merge Modi 
p Components 
Dependency 
Q Exclusion 
|} Files 


ames 


SQL Server Core Files Merge Mod 
SQL Server Tools Core Files Merg 
VBScriptRuntime 


$i Jii 
Products $ Merge Modules 


The following information is displayed: 


Column Description 

ProductName Name of product associated with this Merge Module. 
ProductVersion Version of product associated with this Merge Module. 
Manufacturer Manufacturer of the product associated with this Merge Module. 


InstallShield Software Corporation © 2004 878 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


OS Snapshot Views 


When you click on an OS Snapshot in the products explorer, details about the snapshot appear in the right pane of 
the user interface. 


HoweTechnology.mdb - InstallShield ConflictSolver 


Uk atalog Edit Vi 


WindowsXP 
a ii Groups me o5 Snapshot view 
H-A ACEO6Conflict (v1 00.0000) Conflict Results Conflicts last checked on Friday, October 03, 2003. 


a = pri ig version Windows XP - 5.1.2600 


DemoPlayer (v1.00.0000) Language English (United States) 

[= InstallShield AdminStudio (v5.01) File \\Testengineering\Testing}...\ConflictSolver\OSC Data\5.0)xP\WindowsxP.osc 

McAfee VirusScan (v4.5.0) Imported On — Friday, August 29, 2003 - 2:18 PM 

eso Tweet 00:0000) Description Enter comments here, 

$ OmniPage Pro 10.0 (v10.0.0.0) 
P®) PackageForTheWeb 4 (v4.0.0) 

Ss PackageForThewWeb 4 (v4.0.0) 


Be) 


E7 
E 
H- 
i+ 
E3] 
4S 
(4 
D- 
i+ 
a! 


£ 


Products b4 Merge Modules 


The following information is displayed: 


Field Description 

Version Version of the operating system of the OS Snapshot, such as Windows XP - 5.1.2600. 
Language The language the operating system was written for. 

File This can be either a hard-coded path or a UNC path. 

Imported On The date and time the OS Snapshot was imported. 

Description You can edit this with additional information about the OS Snapshot. 


Click the plus sign next to the OS Snapshot icon to view these OS Snapshot constituent views: 


Extended Attributes 
Files 

INI File Changes 
Registry 

Shortcuts 
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The Extended Attributes view, accessible from the Extended Attributes node for each package in ConflictSolver, 
displays the optional extended attributes associated with the package. 


HoweTechnology.mdb - InstallShield ConflictSolver 


|| Catalog Edit view Conflicts Reports Tools Help 


= (Gy Groups 
+ R ACEQ6Conflict (v1.00,0000) 
H(i ACETests 
a- Adobe 
(A) DemoPlayer (v1.00.0000) 
=) GR InstallShield AdminStudio (v5.01) 
F Conflicts 
A 
Files!Components 
INI File Changes 
Merge Modules 
w Registry 
E Shortcuts 
Tables 
aÈ McAfee VirusScan (v4.5.0) 
cS) Nartco_ACEO6 Two (v1.00.0000) 
a- NCP 
=- OmniPage Pro 10.0 (v10.0.0.0) 
+) (9) PackageForTheWeb 4 (v4.0.0) 
p3] Fe] PackageForTheWeb 4 (v4.0.0) 
a- Patch 
GH) RegistryDifF 
a- Subscribed 
(Fy Symantec Act! (v4.0.0) 
E- Transforms 
a £4) WindowsXP 


Products 


S v] xf | 


$ Merge Modules 


InstallShield AdminStudio 


ES Extended Attributes View 


Application Name 
Application 
Description 

Application Type 


Application vendor 
Version Number 


Current Status 


Business Criticality 
Installation 
Instructions 

Repackagin 
Requirements 
Hardware 
Requirements 
Software 

p = 

Access 
Requirements 
Department 
Business Owner 

R in 
Owner 
Integration Owner 
Development 
Owner 
License Count 
Licensing 
Agreement 
Support 
Agreement 
Additional 
Documentation 


Repackaging Log 
Validation Log 
Test Script 

Test Results 


InstallShield AdminStudio 
Application preparation and management software for the enterprise 


Management 
5.01 


Requested 
Business Critical 


AdminStudioSInstallGuide.doc 


AdminStudioSRepackagingReg. doc 


Pentium III 500 MHz+, 256+ MB RAM (512 MB preferred), 1.1 GB disk space 


Windows 98, Windows Me, Windows NT 4.0 with Service Pack 6 installed, 
Windows 2000, Windows XP, or Windows Server 2003 with Internet Explorer 


Administrative privileges on the system needed 
Engineering 


Paul Jackson 


Ted Taylor 


Olivia Singh 

Ben Columbo 

15 
LicensingAgreement. doc 


SupportAqreement.doc 


Repackaging Log.txt 
Yalidation Log. txt 
AdminStudioTestScript.doc 
AdminStudioTestResults.doc 


These attributes are dynamically populated based on an external extended attribute description file (in XML format). 
You can specify the name and location of this file from the Extended Attributes tab of the Options dialog box. 


On the left side of the view, the name for each attribute is displayed; the right side displays the value for the attribute. 
These values are in read-only fields, from which you can highlight and copy text, or, in the case of file links, launch 
the linked file. The file location displayed represents the location from which the file was originally imported; the file 
is actually stored within the Application Catalog and extracted into a temp directory when you click on the file link. 
This temp directory is purged when ConflictSolver closes, as long as the file is not locked by another application or 


process. 


If you click on the attribute name, you can either provide the value in the Extended Attribute Property Dialog (for 
Text attributes) or browse for a file in a Browse dialog (for File attributes). 
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Files View 


When you expand an OS Snapshot in the products explorer, you can click on Files to display a list of the files included 


in the OS Snapshot. 


HoweTechnology.mdb - InstallShield ConflictSolver 


| Catalog Edit View Conflicts Reports Tools Help 


ACEO6Conflict (v1.00,0000) i 


H ACETests 
4) Adobe 


+- DemoPlayer (v1.00,.0000) 
ala InstallShield AdminStudio (v5. 


GH 4 McAfee VirusScan (v4.5.0) 


448 Nartco_ACE06 Two (v1.00.0C 


a- OmniPage Pro 10.0 (v10.0.0.1 
GS) PackageForTheWeb 4 (v4.0.C 
E PackageForTheWeb 4 (v4.0.C 


w- Patch 
cH FS ReaistryDiff 
(= Subscribed 


cH [Ey Symantec Act! (v4.0.0) 


w- Transforms 
B- WindowsxP 
FR Conflicts 


Ef Extended Attributes 


Files 
-$ INI File Changes 


a Registry 


E Shortcuts 
Tables 


Products 


$ Merge Modules 
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CAR) 


FileName 


$WinMgmt.CFG 

$winnt$. inf 

_DEFAULT.PI_ 

_default. pif 
{02D4B~1,.CRM|{02D4B3... 
O_chart. gif 

O_chart. gif 
000000~1,.QUE|0000000,.. 
000000~2.QUE|0000000.. 
000000~3,QUE|0000000. , 
000000~4,QUE|0000000,., 
000001~1.QUE|0000010... 
000001~2.QUE|0000010.. 
000001~3,.QUE|0000010.. 
000001~4,QUE|0000010,., 
000002~1.QUE|0000020... 
000002~2.QUE|0000020.. 
000002~3,.QUE|0000020. 
000002~4,QUE|0000020,., 
003140~1,.QUE|0000000.., 
003141~1,QUE|0000010., 
003142~1,QUE|0000020.. 
003146~1,QUE|0000000,,, 
00314F~1,QUE|0000010.., 
003150~1,QUE|0000008.. 
003150~2,QUE|0000028, 
003151~1,QUE|0000018.., 
003152~1.QUE|0000008... 


NNE? AUEINANNNAS 


csFilePath 


%oSystemFolder%\wbem\Reposi... 
%oSystemFolder% 

fo I386% 

%olWindowsFolder% 
%oWindowsFolder%\Registration 
%oWindowsFolder%\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\... 
%oWindowsFolder%>\PCHEALTH\,.. 
%oWindowsFolder%\PCHEALTH\,.. 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\, . 
%oWindowsFolder%o\PCHEALTH\,.. 
%o\WindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\,. 
%oWindowsFolder%\PCHEALTH\,.. 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\, . 
%oWindowsFolder%o\PCHEALTH\,.. 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%o\PCHEALTH\... 
%oWindowsFolder%\PCHEALTH\,.. 


%oWindowsFolder%o\PCHEALTH\... 
OF AMindeweE alder. SOCHE Al THY 


FileSize 


Version Language Attributes 


A 


4n additional 12736 records were not included in the display results to improve performance. 


The following information is displayed for each of the files included in the OS Snapshot: 


Column Description 

FileName Name of the file. 

csFilePath Path 

FileSize Size of the OS Snapshot file. 

Version Version of the OS Snapshot file. 

Language Language that the OS Snapshot file was written for. 
Attributes Any attributes associated with the file. 


You can sort by any column by clicking the appropriate column title. 
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INI File Changes View 


When you expand an OS Snapshot in the products explorer, you can click on INI File Changes to display any INI file 
changes made by the snapshot. 


HoweTechnology.mdb - InstallShield ConflictSolver DAR) 


|| catalog Edit Yiew Conflicts Reports Tools Help 


WindowsXP 

5 (GS Groups INI File Changes View 
-GÈ ACEO6Conflict (v1.00.0000) 
-G ACETests 


FileName csFullPath Section Key Value 


desktop.ini %>_DOCUMENTS_AND_...  LocalizedFileN.., Launch Inter... @%.%systemroot%... 
desktop.ini %>_DOCUMENTS_AND_... LocalizedFileN... Windows Med... @C:\WINDOWS\inf\... 
desktop.ini %>_DOCUMENTS_AND_...  .ShellClassInfo LocalizedRes... @shell32.dll,-21765 
{ Desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo IconFile %o%oSystemRoaat%... 
| ls McAfee VirusScan (v4.5.0) Desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo IconIndex -173 
) (8 Nartco_ACE06 Two (v1.00.0000) Desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo LocalizedRes... @shell32.dll,-12693 
desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo UICLSID {?7BD29E00-76C1-11... 
JA š desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo CLSID {FF393560-C247-11... 
En a it a Hines desktop.ini %_DOCUMENTS_AND_.., .ShellClassInfo UICLSID {7BD29E00-76C1-11... 
E. ackageForTheWeb 4 (v4.0.0) desktop.ini %_DOCUMENTS_AND_.., .ShellClassInfo CLSID {FF393560-C2A7-11... 
) GE] PackageForTheWeb 4 (v4.0.0) desktop.ini %_DOCUMENTS_AND_.., .ShellClassInfo UICLSID {7BD29E00-76C1-11... 
+) (5) Patch desktop.ini %_DOCUMENTS_AND_... .ShellClassInfo UICLSID {7BD29E00-76C1-11... 
D RegistryDiff desktop.ini  %_DOCUMENTS_AND_...  ShellClassInfo UICLSID {7BD29E00-76C1-11... 
B © Subscribed desktop.ini %o_DOCUMENTS_AND_...  .ShellClassInfo UICLSID {7BD29E00-76C1-11... 
w- Symantec Act! (v4.0.0) desktop.ini %_DOCUMENTS_AND_... .ShellClassInfo UICLSID {7BD29E00-76C1-11... 
w © Transforms desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo UICLSID {?7BD29E00-76C1-11... 
3-A WindowsXP desktop.ini %_DOCUMENTS_AND_...  .ShellClassInfo LocalizedRes.., @shell32.dll,-21774 
el i Desktop.ini  %_DOCUMENTS_AND_... DeleteOnCopy Owner Administrator 
FR Conflicts Desktop.ini %_DOCUMENTS_AND_... DeleteOnCopy Personalized 13 
@ Extended Attributes Desktop.ini %_DOCUMENTS_AND_... DeleteOnCopy Personalized... My Music 
Files Desktop.ini %>_DOCUMENTS_AND_...  .ShellClassInfo InfoTip @Shell32. dll,-12689 
- INI File Changes Desktop.ini %o>_DOCUMENTS_AND_...  .ShellClassInfo IconFile Y%o%oSystemRoot%... 
a Registry Desktop.ini %>_DOCUMENTS_AND_...  .ShellClassInfo = IconIndex -237 
E Shortcuts Desktop.ini %_DOCUMENTS_AND_... DeleteOnCopy Owner Administrator 
ml Tabl Desktop.ini %_DOCUMENTS_AND_... DeleteOnCopy Personalized 39 
ap ‘ables Desktop.ini %>_DOCUMENTS_AND_... DeleteOnCopy Personalized... My Pictures 
iil Desktop.ini %>_DOCUMENTS_AND_...  .ShellClassInfo InfoTip @Shell32. dil, -12688 
= Desktop.ini %>_DOCUMENTS_AND_...  .ShellClassInfo IconFile %o%oSystemRoot%,.. 
Products Desktop.ini %_DOCUMENTS_AND_... .ShellClassInfo  Iconīndex -101 


4n additional 5533 records were not included in the display results to improve performance, 


The following information is displayed for each change to the INI file that is made by the snapshot: 


Column Description 

FileName Name of INI File that the OS Snapshot makes an entry in. 
csFilePath Path 

Section The section of the INI File where this entry is made. 

Key The Key used in the INI File entry 

Value The Value used in the INI File entry. 


You can sort by any column by clicking the appropriate column title. 


InstallShield Software Corporation © 2004 882 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


Registry View 


When you expand an OS Snapshot in the products explorer, you can click on Registry to display any registry entries 
created or changed by the product. 


DER) 


HoweTechnology.mdb - InstallShield ConflictSolver 


| Catalog Edit Yiew Conflicts Reports Tools Help 


* WindowsXP 
E (Gs Groups Registry View 
H-È ACEOSConflict (v1.00,0000) 
(H(i ACETests 
H- Adobe 
{4} DemoPlayer (v1.00.0000) 
H- InstallShield AdminStudio (v5.01) 
Hf McAfee VirusScan (v4.5.0) 
ol) Nartco_ACE06 Two (v1.00.0000) 
cy NCP 
a OmniPage Pro 10.0 (v10.0.0.0) 
GĦ PackageForTheWeb 4 (v4.0.0) 
co (AY PackageForTheWeb 4 (v4.0.0) 
G5) Patch 


Root Key Name Value 
+ QuickTip prop: Type; Size 

AlwaysSho... 

TileInfo prop: Type; Size 

InfoTip prop: Type;DocAuthor;DocTitle;DocSubject;DocComm... 
*OpenWithList\Excel.exe 
*OpenWithList\IExplore... 
*OpenWithList\MS5Paint... 
*OpenWithList\Notepad... 
*OpenWithList\winwor... 
*OpenWithList\wWordPa... 
*\shellex\ContextMenuH... 
*\shellex\\ContextMenuH... 


Start Menu Pin 
{750fdf0e-2a26-1 1d1-a3ea-080036587F03} 


Sy RegistryDiff 
H- Subscribed 
# Symantec Act! (v4.0.0) 
H- Transforms 
B- WindowsxP 


*\shellex\ContextMenuH... 
*\shellex\ContextMenuH., .. 
*\shellex\PropertySheet... 
*\shellex\PropertySheet... 
*\shellex\PropertySheet... 
*\shellex\PropertySheet... 


{09799A4FB-AD67-11d1-ABCD-00CO4FC30936} 
{4470F8CF-41E8-4f65-8335-2274754845C46} 


Summary Properties Page 
{7444C719-39BF-11D1-8CD9-00C04FC29D45} 


3 conflicts 
Bf} Extended Attributes 


ji a 
Files 
INI File Changes 


E Registry 
E Shortcuts 


E] Tables 


iui 


Products $ Merge Modules 


ån additional 58877 records were not included in the display results to improve performance. 


323 h323file 

323 Content T.., text/h323 

386 vxdfile 

386 Perceived... system 

aca ågent.Character.2 
„acf Agent. Character.2 
acs ågent.Character2.2 
acw acwfile 

„ai Content T... application/postscript 
„aif AIFFFile 

„aif Content T...  audio/aiff 


oooo0oo0o0o0o0o0o0oo0oo0ooeo0oo0o0oooeo0ooeoqoooeooooa 


u 


The following information is displayed for each registry entry: 


Registry 
Root 
Key 
Name 
Value 


You can sort by any column by clicking the appropriate column title. 
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Shortcuts View 


When you expand sn OS Snapshot in the products explorer, you can click on Shortcuts to display any shortcuts that 
were found on this OS Snapshot's operating system. 


HoweTechnology.mdb - InstallShield ConflictSolver WEE 


| Catalog Edit View Conflicts Reports Tools Help 


Fa WindowsxP 
= (Gs Groups Shortcuts View 


cB ACEDEConflict (v1.00.0000) Dreta 


Ex & dria Launch Internet Explorer Browser %_DOCUMENTS_AND_SETTINGS%\Adm... %ProgramFilesFolder%\Internet | 
E (& Adobe Magnifier %>_DOCUMENTS_AND_SETTINGS%>\4dm...  %oSystemFolder%\magnify.exe | 
6 {) DemoPlayer (v1.00.0000) Narrator %_DOCUMENTS_AND_SETTINGS%\Adm.., %SystemFolder%\narrator.exe | 
E-G InstallShield AdminStudio (v5.01) On-Screen Keyboard %_DOCUMENTS_AND_SETTINGS%\Adm...  %SystemFolder%losk.exe | 
H- McAfee VirusScan (v4.5.0) Utility Manager %_DOCUMENTS_AND_SETTINGS%\4dm,., %oSystemFolder%olutilman.exe js. | 
E-F] Nartco_ACEO6 Two (v1.00.0000) Address Book %_DOCUMENTS_AND_SETTINGS%\Adm... %oProgramFilesFolder%\Outlook , | 

| 


Command Prompt %>_DOCUMENTS_AND_SETTINGS%\Adm,... %SystemFolder% cmd.exe 
= ‘ Notepad %>_DOCUMENTS_AND_SETTINGS%\Adm... %SystemFolder%\notepad.exe — 
3 Omnipage real eee Synchronize %_DOCUMENTS_AND_SETTINGS%\Adm...  %oSystemFolder%\mobsync.exe 
2] PackageForTheWeb 4 (v4.0.0) Tour Windows XP %_DOCUMENTS_AND_SETTINGS%\Adm...  %SystemFolder%\tourstart.exe 
E-F] PackageForTheWeb 4 (v4.0.0) Windows Explorer %_DOCUMENTS_AND_SETTINGS%\adm... %WindowsFolder%s\explorer.exe 
E Patch Internet Explorer %_DOCUMENTS_AND_SETTINGS%\Adm...  %oProgramFilesFolder%\Internet 
+ RegistryDiff Outlook Express %_DOCUMENTS_AND_SETTINGS%\4dm...  %ProgramFilesFolder% Outlook . 
H- Subscribed Remote Assistance %_DOCUMENTS_AND_SETTINGS%\4dm...  %SystemFolder%\rcimiby.exe -L. 
Fs Symantec Act! (v4.0.0) Accessibility Wizard PROGRAMS\Accessories\Accessibility esystemFolder%\accwiz.exe 
H- Transforms HyperTerminal PROGRAMS Accessories|Communications %oProgramFilesFolder%\Windows 
Fal WindowsXP Network Connections PROGRAMS \Accessories\Communications %o\WindowsFolder%\explorer.ex.. 
: i Network Setup Wizard PROGRAMS Accessories\Communications %SystemFolder%\rundll32.exe h 
SR Conflicts New Connection Wizard PROGRAMS\Accessories\Communications — %SystemFolder%\rundli32.exe n 
A Extended Attributes Remote Desktop Connection PROGRAMS Accessories Communications %SystemFolder%\mstsc.exe 
|) Files Sound Recorder PROGRAMS \Accessories\Entertainment %oSystemFolder%\sndrec32.exe 
INI File Changes volume Control PROGRAMS \Accessories\Entertainment %oSystemFolder%o\sndvol32,.exe 
ey Registry Activate Windows PROGRAMS \Accessories|System Tools %oSystemFolder%\oobe\msoobe, 
EJ Shortcuts Backup PROGRAMS\Accessories|System Tools %oSystemFolder%\ntbackup.exe 
a Tables Character Map PROGRAMS Accessories\System Tools %oSystemFolder%\charmap.exe 
Disk Cleanup PROGRAMS \Accessories|System Tools %oSystemFolder%o\cleanmar.exe 
ral T Disk Defragmenter PROGRAMS Accessories\System Tools %SystemFolder%\dfrg.msc 


Products b4 Merge Modules 2 m 


Files and Settings Transfer Wizard PROGRAMS\Accessories\System Tools %oSystemFolder%\usmt\miqwiz.e: Sd) 


The following information is displayed: 


Column Description 

Name Name of shortcut. 

Directory Location of shortcut. 

Target The application executable that the shortcut points to. 


You can sort by any column by clicking the appropriate column title. 
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Tables View 


The Tables view provides a way to view the data for a given package in the Application Catalog. Select the specific 
table you want to view from the Tables list at the top of the view. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit View Conflicts Reports Tools Help 


sum) Adobe PageMaker 6.5 6.5 


E E Groups fue Tables 
{©} Accounting — 
5 ACEO6 (v1.00.0000) Tables — fesmsiRadioButton v 


& ACEO6Conflict (v1.00.0000) as Onan eae x 
#488 Adobe Acrobat Reader (v5.0) 1 No o 
= È Adobe PageMaker 6.5 (v6.5) 2 Yes 0 

R Conflicts _IsSetupTypeMin 1 Typical 0 
@ Extended Attributes _IsSetupTypeMin 2 Custom 0 
Files}Components _IsMaintenance 1 Change 0 

2 0 

3 0 

1 1 

2 1 


width Height 


AgreeToLicense 
AgreeToLicense 


INI File Changes _IsMaintenance Reinstall 
Merge Modules _IsMaintenance Remove 
Reaist ApplicationUsers AllUsers 
eaistry ApplicationUsers OnlyCurrentUser 
Shortcuts 


Tables 
HS DemoPlayer (v1.00,0000) 


| InstallShield Software Corporatio 
{© Marketing 
wF] Nartco_ACE06 (v1.00.0000) 
| 


Products $ Merge Modules 


DAAaaaaanrg 


Most tables are derived directly from standard MSI tables, as described in the Windows Installer SDK online help. 


When building your own ACE rules to use for conflict identification, it is important to understand the data available 
for packages so you can construct the necessary rule. 


You can sort by any column by clicking the appropriate column title. 
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Other Setup Types Views 


When you click on an Other Setup Types package (a package containing non-MSI based setup files) in the products 
explorer, details about that setup are displayed in the right pane of the user interface. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


| Catalog Edit View Conflicts Reports Tools Help 


FES, RegistryTool 
& (i Groups FEB Product view 
(€ Accounting Main Directory — C:\AdminStudio Shared\OtherSetup Data\ReaistryDiffTool 


a 
4 ACEDS (v1.00,0000) Options Full directory hierarchy imported 


E-G ACEOSConflict (v1.00.0000) 
E-G Adobe Acrobat Reader (v5.0) Imported On Monday, January 12, 2004 - 5:33 PM 
a 2 Adobe PageMaker 6.5 (v6.5) Description | 

E DemoPlayer (v1.00,0000) | 

@ InstallShield Software Corporation_Package 

{© Marketing 

® Nartco_ACE06 (v1.00,0000) 

E] Norton Antivirus Corporate Edition (v7.5.0. 
454 Orca (v1.50.2600,0000) | 


Size Date Modified Relative Path 
(J file_id.diz 0.40KB 11/30/2000 5:32 PM 
| Jhistory.txt  3.10KB 12/1/2000 4:28 PM 
B) license.txt 2.00 K6 6/17/1999 7:27 PM 
| [J order.frm 3.10KB 7/5/2000 8:30 PM 


f 
f 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


E] (d PackageForTheweb 4 (v4.0.0) 
B- Research 
[E] RegistryTool 
EÑ Extended Attributes 


E Tables 


E Fasl Visual FoxPro ODBC Driver (v1.0.0) 


| _Jorder.txt 1.70KB 7/5/2000 8:32 PM 
| JReadme.txt 3.00KB 11/30/2000 6:42 PM 
(_JSetup.ExE 706.00KB 12/1/2000 4:31 PM 


The following information is included: 


Field Description 


Main Directory The original location of the non-MSI based setup files when they were imported into 
ConflictSolver. 


Imported On The date and time the setup was imported. 


Files A listing of the individual files making up the setup are listed, allowing you to view or 
delete files by making a selection from the context menu. 


= To view the contents of a file, select View from the context menu. You can only view 
files supported by applications installed on your workstation. If you attempt to view a 
non-supported file, no View window will appear. If you attempt to view an executable, 
that executable will be launched. 


= To delete a file from this setup, select Delete from the context menu. 


If you expand an Other Setup Type, you can view its constituent view: 


E Extended Attributes View 
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The Extended Attributes view, accessible from the Extended Attributes node for each package in ConflictSolver, 
displays the optional extended attributes associated with the package. 


HoweTechnology.mdb - InstallShield ConflictSolver 


|| Catalog Edit view Conflicts Reports Tools Help 


= (Gy Groups 
+ R ACEQ6Conflict (v1.00,0000) 
H(i ACETests 
a- Adobe 
(A) DemoPlayer (v1.00.0000) 
=) GR InstallShield AdminStudio (v5.01) 
F Conflicts 
A 
Files!Components 
INI File Changes 
Merge Modules 
w Registry 
E Shortcuts 
Tables 
aÈ McAfee VirusScan (v4.5.0) 
cS) Nartco_ACEO6 Two (v1.00.0000) 
a- NCP 
=- OmniPage Pro 10.0 (v10.0.0.0) 
+) (9) PackageForTheWeb 4 (v4.0.0) 
p3] Fe] PackageForTheWeb 4 (v4.0.0) 
a- Patch 
GH) RegistryDifF 
a- Subscribed 
(Fy Symantec Act! (v4.0.0) 
E- Transforms 
a £4) WindowsXP 


Products 


S v] xf | 


$ Merge Modules 


InstallShield AdminStudio 


ES Extended Attributes View 


Application Name 
Application 
Description 

Application Type 


Application vendor 
Version Number 


Current Status 


Business Criticality 
Installation 
Instructions 

Repackagin 
Requirements 
Hardware 
Requirements 
Software 

p = 

Access 
Requirements 
Department 
Business Owner 

R in 
Owner 
Integration Owner 
Development 
Owner 
License Count 
Licensing 
Agreement 
Support 
Agreement 
Additional 
Documentation 


Repackaging Log 
Validation Log 
Test Script 

Test Results 


InstallShield AdminStudio 
Application preparation and management software for the enterprise 


Management 
5.01 


Requested 
Business Critical 


AdminStudioSInstallGuide.doc 


AdminStudioSRepackagingReg. doc 


Pentium III 500 MHz+, 256+ MB RAM (512 MB preferred), 1.1 GB disk space 


Windows 98, Windows Me, Windows NT 4.0 with Service Pack 6 installed, 
Windows 2000, Windows XP, or Windows Server 2003 with Internet Explorer 


Administrative privileges on the system needed 
Engineering 


Paul Jackson 


Ted Taylor 


Olivia Singh 

Ben Columbo 

15 
LicensingAgreement. doc 


SupportAqreement.doc 


Repackaging Log.txt 
Yalidation Log. txt 
AdminStudioTestScript.doc 
AdminStudioTestResults.doc 


These attributes are dynamically populated based on an external extended attribute description file (in XML format). 
You can specify the name and location of this file from the Extended Attributes tab of the Options dialog box. 


On the left side of the view, the name for each attribute is displayed; the right side displays the value for the attribute. 
These values are in read-only fields, from which you can highlight and copy text, or, in the case of file links, launch 
the linked file. The file location displayed represents the location from which the file was originally imported; the file 
is actually stored within the Application Catalog and extracted into a temp directory when you click on the file link. 
This temp directory is purged when ConflictSolver closes, as long as the file is not locked by another application or 


process. 


If you click on the attribute name, you can either provide the value in the Extended Attribute Property Dialog (for 
Text attributes) or browse for a file in a Browse dialog (for File attributes). 
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NCP View 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


When you select a Marimba NCP file (.ncp) from the products explorer, details about that file are displayed in the 
right pane of the user interface. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


= G Groups NCP View 
{& Accounting Conflict Results — There is no conflict information persisted for this product. 


ACEO6 (v1.00.0000) o E 
B 


HG ACEOSConflict (v1.00.0000) : ; i 
E-E Adobe Acrobat Reader (v5.0) File C:\AdminStudio Shared\Rumba_Marimba\manifest.ncp 


E3] Adobe PageMaker 6.5 (v6.5) Imported On Monday, January 12, 2004 - 5:36 PM 
(E7 = DemoPlayer (v1.00,0000) Description 
®© InstallShield Software Corporation _PackageF 
{£ Marketing 
E Nartco_ACE06 (¥1.00.0000) 
aw Norton Antivirus Corporate Edition (v7.5.0.0° 
SE} Orca (v1,50,2600,0000} 
aw R PackageForTheweb 4 (v4.0.0) 
H- Research 
a Rumba 
5% Conflicts 
@ Extended Attributes 


|} Files 
INI File Changes 


ae Registry 


E Shortcuts 


E Tables 


S- Visual FoxPro ODBC Driver (v1.0.0) 


k4 Merge Modules 


The following information is included: 


Column Description 

Conflict Results Date that this package was last checked for conflicts. Click the link to jump to the Conflicts View. 
Version Version of the software package 

File Name and path of the NCP file that was imported 

Imported On Date when the file was imported 

Description After the NCP file is imported, you can edit this with additional information. 
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If you expand an NCP file, you can view its constituent views: 


Conflicts View 

Extended Attributes View 
Files View 

INI File Changes View 
Registry View 

Shortcuts View 

Tables View 


Conflicts View 


Each product contains a Conflicts view, where you can access information pertaining to the last execution of the 
Conflict Wizard. This persisted conflict data allows you to view when the last execution was performed, the products 
that it was run against, the ACE rules used, and conflicts discovered. The view also provides a list of updated, deleted, 
or added products that may necessitate performing conflict identification again. 


Summary Information 


The main area of this view displays summary information for the last conflict identification execution. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


| Catalog Edit Yiew Conflicts Reports Tools Help 


E G Groups 


E Accounting T - 3 
H-Q} InstallShield Software Corporation _F Conflict Information 


{3 Marketing Summary 

a- Orca (v1.50.2600,0000) 

=| frm PackageForTheWeb 4 (v4.0.0) When conflict identification was performed on 'PackageForTheWeb 4' on ‘Monday, January 12, 2004 - 12:41 
È Conflicts PM’, a total of 3 conflicts) were identified, of which 3 are automatically resolvable, by checking a total of: 


Ef Extended Attributes 


Files/Components 1 A | | Run Again | 
i fl ís). 
INI File Changes n TEAS 


Merge Modules None of these product(s) have been updated, 


E Registry None of these product(s) have been deleted. 
E Shortcuts No new product(s) have been added to the AdminStudio Application Catalog, 


on Lari Resolution Options 
Researc 


The conflict resolution options for this package are to: 
Resolve Conflicts: Save the resolutions within a transform file. 
C:\AdminStudio Shared\PackageForTheWeb 41.mst 


You can modify these resolution options by selecting ‘Edit’, 


Ca 


Products $ Merge Modules 
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This information includes: 


m The name of the product on which conflict m The ACE rules used during conflict identification. 


identification was performed. m The number of checked packages that have 


m The date and time of the last conflict identification. changed since conflict identification. 
m The number of conflicts detected. m The number of checked packages that have been 
deleted from ConflictSolver since conflict 


m The number of detected conflicts which can be : f ; 
: identification. 
resolved automatically. 
m The number of packages that have been imported 


m The products the current product was checked . i j BD i : 
P P into ConflictSolver since conflict identification. 


against. 


Links 


When you click on one of the informational links, the Conflict Information Dialog appears, displaying information on 
the selected link. For example, if you click on the ACE rule link, the Conflict Information dialog appears with the 
ACE Rules tab selected. 


Run Again and Reimport Buttons 


Click Run Again to perform conflict identification on the package again, using the specified packages (if they still exist 
in ConflictSolver) and ACE rules. Because packages may have been removed or modified, conflict identification may 
return different results. Click Reimport to import the package into ConflictSolver again. This is usually done if you 
have already modified the package, and need to run conflict identification again. 


Conflict Information 


Using the pull-down list at the top of the view, you can toggle between summary information and conflict-specific 
information. When you select a specific conflict type, the view changes to display a list of corresponding errors in the 


product, grouped by ACE. 


testlabsq|2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


= PackageFor TheWeb 4 al 
& 
> 


E (Gs Groups "SM Conflict view 


{© Accounting ETA E z : 
a A InstallShield Software Corporation _F ere elem Product Properties v 


{) Marketing Conflict Details 
FY Orca (v1.50,2600,0000) ay 


B A PackageForTheWeb 4 (v4.0.0) 5 The package code '{5E6C9285-00E1-4547-AB97-C2577E0A6F71}' is the same in 1 other packages). 
3% Conflicts BSS Acei9 
A Extended Attributes (2) The product code '{C9COAF10-7B04-449E-9FAC-5436D2E238EC} is the same in 1 other package(s). 
; Files{Components SS Acezo 


3a telah a) The upgrade code {85447089-A809-495E-BC9A-7DF40EBBSE82}' is the same in 1 other package(s). 
erge Module: 


Ef Registry 
E Shortcuts 


Tables 
{© Research 
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The icon displayed next to the conflict indicates its status: 


Icon Status 


ə Resolvable 


iv) Resolved 


(x Unresolvable 


In many cases, these errors can be resolved by clicking either Resolve or Resolve All. In cases where no automatic 


resolution is possible, the Unresolvable @ icon appears next to the conflict and the Resolve button is disabled. 


If one of the following options on the Resolution tab of the Options dialog is selected, you several additional dialogs 
could appear prompting for approval or additional information for user input: 


E Ifthe Preview and approve all resolutions option is selected, the Resolution Details Dialog appears, listing 
the changes that are going to be made and prompting you to approve them. 


= Ifthe Maximize user flexibility in selecting resolutions option is selected, and if you are using a CARD 
with multiple resolution options, a list of options from you to choose from could appear the CARD Resolution 
Options Dialog, prompting you to select one. 


For File Conflicts, click the plus sign next to the conflict icon to see the package that conflicts with the selected 
package. 


Conflict Details 
aR 
=) The file ‘Inetwh32.dll', version '1,10,1.1', in the component 'SystemHelpFiles 
PackageForTheWeb 4 v4.0.0 
RR acez3 
B @ The file 'Inetwh32.dll', size '48640' bytes, version '1.10.1,1', language 'Engli 
PackageForTheweb 4 v4.0.0 


Resolution Options 


This section displays the current resolution option: either resolve in the original Windows Installer package, or using 
the specified transform. Click Edit to change the current settings on the Resolution Options Dialog. 
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The Extended Attributes view, accessible from the Extended Attributes node for each package in ConflictSolver, 
displays the optional extended attributes associated with the package. 


HoweTechnology.mdb - InstallShield ConflictSolver 


|| Catalog Edit view Conflicts Reports Tools Help 


= (Gy Groups 
+ R ACEQ6Conflict (v1.00,0000) 
H(i ACETests 
a- Adobe 
(A) DemoPlayer (v1.00.0000) 
=) GR InstallShield AdminStudio (v5.01) 
F Conflicts 
A 
Files!Components 
INI File Changes 
Merge Modules 
w Registry 
E Shortcuts 
Tables 
aÈ McAfee VirusScan (v4.5.0) 
cS) Nartco_ACEO6 Two (v1.00.0000) 
a- NCP 
=- OmniPage Pro 10.0 (v10.0.0.0) 
+) (9) PackageForTheWeb 4 (v4.0.0) 
p3] Fe] PackageForTheWeb 4 (v4.0.0) 
a- Patch 
GH) RegistryDifF 
a- Subscribed 
(Fy Symantec Act! (v4.0.0) 
E- Transforms 
a £4) WindowsXP 


Products 


S v] xf | 


$ Merge Modules 


InstallShield AdminStudio 


ES Extended Attributes View 


Application Name 
Application 
Description 

Application Type 


Application vendor 
Version Number 


Current Status 


Business Criticality 
Installation 
Instructions 

Repackagin 
Requirements 
Hardware 
Requirements 
Software 

p = 

Access 
Requirements 
Department 
Business Owner 

R in 
Owner 
Integration Owner 
Development 
Owner 
License Count 
Licensing 
Agreement 
Support 
Agreement 
Additional 
Documentation 


Repackaging Log 
Validation Log 
Test Script 

Test Results 


InstallShield AdminStudio 
Application preparation and management software for the enterprise 


Management 
5.01 


Requested 
Business Critical 


AdminStudioSInstallGuide.doc 


AdminStudioSRepackagingReg. doc 


Pentium III 500 MHz+, 256+ MB RAM (512 MB preferred), 1.1 GB disk space 


Windows 98, Windows Me, Windows NT 4.0 with Service Pack 6 installed, 
Windows 2000, Windows XP, or Windows Server 2003 with Internet Explorer 


Administrative privileges on the system needed 
Engineering 


Paul Jackson 


Ted Taylor 


Olivia Singh 

Ben Columbo 

15 
LicensingAgreement. doc 


SupportAqreement.doc 


Repackaging Log.txt 
Yalidation Log. txt 
AdminStudioTestScript.doc 
AdminStudioTestResults.doc 


These attributes are dynamically populated based on an external extended attribute description file (in XML format). 
You can specify the name and location of this file from the Extended Attributes tab of the Options dialog box. 


On the left side of the view, the name for each attribute is displayed; the right side displays the value for the attribute. 
These values are in read-only fields, from which you can highlight and copy text, or, in the case of file links, launch 
the linked file. The file location displayed represents the location from which the file was originally imported; the file 
is actually stored within the Application Catalog and extracted into a temp directory when you click on the file link. 
This temp directory is purged when ConflictSolver closes, as long as the file is not locked by another application or 


process. 


If you click on the attribute name, you can either provide the value in the Extended Attribute Property Dialog (for 
Text attributes) or browse for a file in a Browse dialog (for File attributes). 
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Files View 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


When you expand a Marimba NCP File in the products explorer, you can click on Files to display the files included in 
the NCP File. 


testlabsql2k (HowePublisher2004) - sa - InstallShield ConflictSolver DER) 


| Catalog Edit Yiew Conflicts Reports Tools Help 


4 


= (Gs Groups 
{©} Accounting 
a GS ACEOS (v1.00.0000) 


A-G ACEOSConflict (v1.00,0000) @ WindowsFolder 7 


f] Adobe Acrobat Reader (v5.0) _inst32i.ex_ ProgramFilesFolder\WallData|\SETUP 316789 
cs Adobe PageMaker 6.5 (v6.5) _isdel.exe ProgramFilesFolder|WallData\SETUP 
H-E] DemoPlayer (v1.00,0000) _rum95.bmp ProgramFilesFolder\\WallData\SETUP 
W-E} InstallShield Software Corporation_Pack] | _rum9516.bmp ProgramFilesFolder\WallData\SETUP 
(© Marketing _setup.dll ProgramFilesFolder\WallData\SETUP 
@ es Nartco_ACEO6 (v1.00.0000) _SETUP.LIB ProgramFilesFolder\\WallData\SETUP 


x WindowsFolde: 
aw Norton Antivirus Corporate Edition (v7.! J ohare 


csFilePath FileSize Version Language Attributes 
Creating ARPEGGIO R... ProgramFilesFolder\WallData\ARP... 432640 


_ 00000001 WindowsFolder\CSC 
-E Orca (v1.50.2600.0000) 00000002 WindowsFolder\C5C 

E- PackageForThewWeb 4 (v4.0.0) 1027.500 ProgramFilesFolder\wallData\S'S. .. 

E- Research 1027.850 ProgramFilesFolder\WallData\SYS... 

= Rumba 1996. txt ProgramFilesFolder\WallData\SY¥S... 

RH Conflicts 1997, txt ProgramFilesFolder\wallData\SYS... 

i X ProgramFilesFolder\WallData\ S'S... 

ar Extended ee ProgramFilesFolder\WallData\ SYS... 

A Files à ProgramFilesFolder\WallData\S¥5... 

INI File Changes f ProgramFilesFolder\WallData\SYS. .. 

ey Registry ProgramFilesFolder\WallData\SYS. .. 

E Shortcuts ProgramFilesFolder\WallData\S¥5... 

a Tables ProgramFilesFolder\WallData\ S'S... 

m Visual FoxPro ODBC Driver (v1.0.0) 297,850 ProgramFilesFolder\wallData\SYS. .. 

3270.htm ProgramFilesFolder\WallData\R41I... 

37.850 ProgramFilesFolder\WallData\S¥5... 

3dwave.rgs ProgramFilesFolder\WallData\ SYS... 

— = 437,850 ProgramFilesFolder\WallData\S7S... 

Products 500.850 ProgramFilesFolder\WallData\SYS. .. 


Corn bee Denn anail elle Us lI abt AT 


An additional 1697 records were not included in the display results to improve performance. 


P27oOooqo0qooeoeoeoeoeoeoeoeoeoeeoeoeoeoeo0oeoeoeoeoeo0oe0dcHe 
ypoooocoocoococoococoococococoocococoft sO TC s E ma E ma B man E on E s E s 


The following information is displayed for each file: 


Column Description 
FileName Name of the file. 
csFilePath Path 

FileSize Size of the NOP file. 
Version Version of the NCP file. 
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Column Description 
Language Language that the NCP file was written for. 
Attributes Any attributes associated with the file. 


You can sort by any column by clicking the appropriate column title. 


INI File Changes View 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


When you expand an Marimba NCP File in the products explorer, you can click on INI File Changes to display any 
INI file changes made by the NCP file. 


testlabsql2k (HowePublisher2004) - sa - InstallShield ConflictSolver DAR) 


| catalog Edit view Conflicts Reports Tools Help 


| 
J 


Rumba 
& G Groups INI File Changes 


© Accounting FileName csFullPath Section Key Value 
GÈ ACEO6 (v1.00,0000) 


' RRLBLSZ0,INI ProgramFilesFolder\WallData\ARPEGGIO Labels LSK-3 Avery Index Maker 3 Tab, L, 0.500, 3 

Š ACEO6Conflict (v1.00.0000) RRLBLS20.INI ProgramFilesFolder\WallDatalARPEGGIO Labels LSK-5 Avery Index Maker 5 Tab, L, 0.500, 1 

f] Adobe Acrobat Reader (v5.0) RRLBLSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels  LSK-8 Avery Index Maker 8 Tab, L, 0.500, 1 
Adobe PageMaker 6.5 (v6.5) RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels  WS5-5 Avery WorkSaver 5 Tabs, L, 0.333, 4 — 

) DemoPlayer (v1.00,0000) RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels W5-8 Avery WorkSaver 8 Tabs, L, 0.333, 3 

E Fz InstallShield Software Corporation _Pact RRLBLSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML 099 Avery Diskette, P, 1.940, 2.750, 1, 1, 

{© Marketing RRLBLSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML 102 Avery Address, P, 1.440, 4.000, 1, 1. 

E-G Nartco_ACEO6 (v1.00.0000) RRLBLSZ0.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML103 Avery Address, P, 1.940, 4.000, 1, 1, 

> G ies = l RRLBLSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML 105 Avery Address, P, 1.940, 5.000, 1, 1. 

cs) Norton Antivirus Corporate Edition (v7.! 


= RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML 106 Avery Address, P, 1.440, 3.500, 1, 1, 

HE) Orca (v1,50,.2600.0000) RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML202Avery Address, P, 1.440, 4.000, 2, 1. 

E-G PackageForTheWeb 4 (v4.0.0) RRLBLS2Z0.INI ProgramFilesFolder|WallData\ARPEGGIO Labels OML203 Avery Address, P, 1.940, 4.000, 2, 1. 

H- Research RRLBLSZ0.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML 302 Avery Address, P, 1.440, 3.500, 3, 1. 

=| Rumba RRLELS2O.INI ProgramFilesFolder\WallData\ARPEGGIO Labels OML303 Avery Address, P, 1.940, 3.500, 3, 1. 

RH Conflicts RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels = RI-213-S Avery Ready Index 5 Tab, L, 2.000, ¢ 

EA! Extended Attributes RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels RI-213-8 Avery Ready Index 8 Tab, L, 1.220, ¢ 

il RRLELSZO.INI ProgramFilesFolder\WallData\4RPEGGIO Labels RI-213-10 Avery Ready Index 10 Tab, L, 1.000, 

a Files RRLELSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels RI-213-12 Avery Ready Index 12 Tab, L, 0.840, 

INI File Changes RRLELS2O.INI ProgramFilesFolder\WallData\ARPEGGIO Labels RI-213-15 Avery Ready Index 15 Tab, L, 0.630, 

Ei Registry RRLELS2O.INI ProgramFilesFolder\WallData\ARPEGGIO Labels 2160 Avery Addressing, M, 1.000, 2.630, 1 

E Shortcuts RRLELSZO.INI ProgramFilesFolder\WallData\4RPEGGIO Labels L2160 Avery Addressing, M, 1.000, 2.630, 1 

a Tables RRLELSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels 2162 Avery Addressing, M, 1.330, 4.000, 1 

w Visual FoxPro ODBC Driver (v1.0.0) RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels 12162 Avery Addressing, M, 1.330, 4.000, 1 

RRLBLS20.INI ProgramFilesFolder\WallData\ARPEGGIO Labels 2163 Avery Shipping, M, 2.000, 4.000, 1, 4 

RRLBLS20,INI ProgramFilesFolder\WallData\ARPEGGIO Labels 12163 Avery Shipping, M, 2.000, 4.000, 1, 4 

RRLELSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels 2180 Avery File Folder - Assorted, M, 0.66 
RRLELSZO.INI ProgramFilesFolder\WallData\ARPEGGIO Labels File Folder - White, M, 0.660, 3 4 


F Products $ Merge Modules a i 


An additional 7069 records were not included in the display results to improve performance. 
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The following information is displayed for each change that is made to the INI file by the NCP file: 


Column Description 

FileName Name of the file. 

csFullPath Path 

Section Section of INI file that is changed. 
Key Key that is changed. 

Value Value that is changed. 


You can sort by any column by clicking the appropriate column title. 
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Registry View 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


When you expand a Marimba NCP File in the products explorer, you can click on Registry to display any registry 
entries created or changed by the NCP file. 
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ea xi 


& G Groups 


] 


(E7 


Products 


{© Accounting 
Š ACE06 (v1,00,0000) 
$ ACEO6Conflict (v1.00,0000) 
[5 Adobe Acrobat Reader (v5.0) 
= Adobe PageMaker 6.5 (v6.5) 
DemoPlayer (¥1.00.0000) 
Fe InstallShield Software Corporation_Pact 
{© Marketing 
Faal Nartco_ACE06 (v1,00,0000) 
Norton Antivirus Corporate Edition (v7.! 
f=) Orca (v1,.50,2600.0000) 
fe PackageForThewWeb 4 (v4.0.0) 
{ Research 
Rumba 
BA Conflicts 
& Extended Attributes 


| _] Files 

a INI File Changes 
E Registry 

E Shortcuts 


Tables 
{9 visual FoxPro ODBC Driver (v1.0.0) 


b4 Merge Modules 


Root 


AINNNNNNNNNNNNNNNEÆENNNNNNNNNNAN 


Key 

HARDWARE 
HARDWARE\DESCRIPTION 
HARDWARE\DESCRIPTION| System 


HARDWARE\DESCRIPTION|System\Centr... 
HARDWARE\DESCRIPTION|System\Centr... 
HARDWARE|DESCRIPTION|System\Centr... 


HARDWARE\DEVICEMAP 
HARDWARE\DEVICEMAP\Scsi 
HARDWARE\DEVICEMAP\Scsi\Scsi Port 0 
HARDWARE\DEVICEMAP\Scsi\Scsi Port 0 
SOFTWARE 

Software 

SOFTWARE\Classes 
SOFTWARE\Classes\* 
SOFTWARE\Classes\*|shellex 


SOFTWARE\Classes\*|shellex\CopyHook... 
SOFTWARE\Classes\*|shellex\CopyHook.,.. 
SOFTWARE\Classes\*\shellex\CopyHook... 


SOFTWARE\Classes\,. BTF 
SOFTWARE\Classes\.BTF 
SOFTWARE\Classes\.dba 
SOFTWARE\Classes\.dba 
SOFTWARE) Classes. dbo 
SOFTWARE\Classes\.dbo 
SOFTWARE) Classes. DSP 
SOFTWARE) Classes. DSP 
SOFTWARE) Classes}. Ftb 


FirstBusScanTimeInMs 


{a73192e1-c66a-11ce-88a7-4445535 
WallData. File TransferDocument 
WallData.FileDBADocument 
WallData.FileDBODocument 


WallData. FileMFDisplayDocument.2 


An additional 7372 records were not included in the display results to improve performance. 


The following information is displayed for each registry entry: 


Column Description 

Root Default value of Key. 

Key Key of the Registry Entry that this NCP file is making. 
Name Name of the Registry Entry that this NCP file is making. 
Value Value of the Registry Entry that this NCP file is making. 
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You can sort by any column by clicking the appropriate column title. 


Shortcuts View 


12 Identifying and Resolving Application Conflicts 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 


AMS 2.0. 


When you expand a Marimba NCP file in the products explorer, you can click on Shortcuts to display any shortcuts 


created by the NCP file. 
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Catalog Edit Yiew Conflicts Reports Tools Help 
xi 


& (Gg Groups 
E Accounting 
È ACEO (v1.00.0000) 
GÈ ACEO6Conflict (v1.00.0000) 
8) Adobe Acrobat Reader (v5.0) 
Adobe PageMaker 6.5 (v6.5) 
3) DemoPlayer (v1.00,0000) 
= InstallShield Software Corporation_Pact 
{© Marketing 
Fe Nartco_ACE06 (v1,00,0000) 
Norton Antivirus Corporate Edition (v7.! 
a- orca (v1.50.2600.0000) 
f fe PackageForTheweb 4 (v4.0.0) 
H-E Research 
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S& Conflicts 
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|] Files 
INI File Changes 


w Registry 
E Shortcuts 
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Ez] visual FoxPro ODBC Driver (v1.0.0) 


D-00000- 


&)- 


0) 


b4 Merge Modules 


Products 


Rumba 
Shortcuts View 


Eok) 


Name 

Add or Remove Components 
APPC Configuration 

Getting Started 

ODBC Trace 

PowerSync 

QuickSync 

RUMBA 45400 Communications 
RUMBA Guardian 

RUMBA ODBC Administrator 
RUMBA Trace 

Submit Remote Command 

Wall Data PTF Installer 
ARPEGGIO Data Access 
ARPEGGIO Data Organizer 
ARPEGGIO Report Shortcut Maker 
ARPEGGIO Report Viewer Help 
ARPEGGIO Report Viewer 
45400 Display 

45400 File Transfer 

45400 Printer 

Help Desk 

HP 

Mainframe Display 

Mainframe Printer 

RUMBA Internet Companion 
RUMBA Notebook 

RUMBA ODBC Driver Help 


< 


Directory 


Target 

ProgramFilesFolder\\WallData\SETUP\setup.exe 
ProgramFilesFolder\\WallData\S¥STEM\config.exe 
ProgramFilesFolder\WallData\SETUP\MRI2924\gshelp. hip 
ProgramFilesFolder\\WallData\DBA\drdbsp32.exe 
ProgramFilesFolder\WallData\SYSTEM\PWRSYNC, EXE 
ProgramFilesFolder\WallData\S¥STEM\QUIKSYNC,.EXE 
ProgramFilesFolder\\WallData\AS400\EHNCFG32, EXE 
ProgramFilesFolder\WallData\SYSTEM\guard32.exe 
ProgramFilesFolder\\WallData\DBA\AdminMgr.exe 
ProgramFilesFolder\WallData\S¥STEM\RUMBATRC,EXE 
ProgramFilesFolder\WallData\AS400\rmtcmd32.exe 
ProgramFilesFolder\\WallData\SETUP\setup.exe 
ProgramFilesFolder\\WallData\DBA\Dbastv32.exe 
ProgramFilesFolder\\WallData\DBA\DbaQuery EXE 
ProgramFilesFolder\\WallData| 4RPEGGIO\rswicon,.exe 
ProgramFilesFolder\\WallData\HELP\MRI2924\rswrun.hip 
ProgramFilesFolder\\WallData\4RPEGGIO\rswrun.exe 
ProgramFilesFolder\WallData\45400\Rumbawsf exe 
ProgramFilesFolder\WallData\AS400\FTX.EXE 
ProgramFilesFolder\WallData\45400\rumbaprn.exe 
ProgramFilesFolder\\WallData\S¥STEM\wdhelp.exe 
ProgramFilesFolder\\WallData\HP\RumbaHP.Exe 
ProgramFilesFolder\\WallData\MFRAME\rumbadsp. exe 
ProgramFilesFolder\WallData\MFRAME\rumbaprt.exe 
ProgramFilesFolder\\WallData\R4INET\inetclnt.exe 
ProgramFilesFolder\WallData\SYSTEM\WdNoteBk, Exe 
ProgramFilesFolder\\WallData\HELP\MRI2924\Dbadrv32.h 


Ip 
a 


The following information is displayed for each shortcut created by the NCP file: 


Field Description 
Name Name of the shortcut. 
Directory Directory where the shortcut will exist. 
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Field Description 


Target Directory and executable that the shortcut invokes. 


You can sort by any column by clicking the appropriate column title. 


Tables View 


The Tables view provides a way to view the data for a given package in the Application Catalog. Select the specific 
table you want to view from the Tables list at the top of the view. 


testlabsql2k (HowePublisher 2004) - sa - InstallShield ConflictSolver 


|| Catalog Edit View Conflicts Reports Tools Help 


Adobe PageMaker 6.5 6.5 
E G Groups A Tables 


{© Accounting we — 
a È ACEO6 (v1.00.0000) Tables  fesmsiRadioButton v 


E: 3 
Eg ACEO6Conflict (v1.00.0000) RowID PkgRowID_ Property Order | value x 
Le Adobe Acrobat Reader (v5.0) AgreeTolicense 1 No 0 

= R Adobe PageMaker 6.5 (v6.5) AgreeTolicense 2 Yes 0 
D Conflicts _IsSetupTypeMin 1 Typical 0 

Ef Extended Attributes _IsSetupTypeMin 2 Custom 0 

|} Files/Components _IsMaintenance 1 Change 0 

2 0 

3 0 

1 1 

2 1 


width Height 


INI File Changes 5 iat adie 
Merge Modules _IsMaintenance emove 
we R a ApplicationUsers AllUsers 
Ory ApplicationUsers OnlyCurrentUser 
Shortcuts 


Tables 
PS DemoPlayer (v1.00.0000) 


E] InstallShield Software Corporatio 
{© Marketing 
wG] Martco_ACE06 (v1.00.0000) 
< | 


Products $ Merge Modules 


DAAanaraannaa 


Most tables are derived directly from standard MSI tables, as described in the Windows Installer SDK online help. 


When building your own ACE rules to use for conflict identification, it is important to understand the data available 
for packages so you can construct the necessary rule. 


You can sort by any column by clicking the appropriate column title. 
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About InstallShield ConflictSolver Dialog 


The About InstallShield ConflictSolver dialog can be accessed by selecting About ConflictSolver from the Help menu. 
This dialog displays information about the product, including the full version number (essential if you need technical 


support). 


ACE Rule Properties Dialog 


The ACE Rule Properties dialog allows you to edit an existing user-defined ACE rule. You can display the dialog by 
clicking Edit on the on the Rules Viewer Dialog. 


You can only edit user-defined ACE rules; you are not permitted to edit the ACE rules that were installed with 
ConflictSolver. 


General Information Tab 


Prom the General Information tab, you can configure information about the new ACE tule. 


ACE Rule Properties 


General Information | Additional Information | Custom Options | Where Clause 


] 
All ACEs require basic information for display and identification. Supply the required data for | 
the following properties: | 


Name: 


CustomRule1 


Associated T able: 


csmsiDirectory 


Brief Description: 
4 short ACE description displayed when selecting an ACE to execute. 


Description: 


4 description of the ACE displayed during ACE execution. _ 


Information URL: 


http://www. yourcompany.com 


This information is used primarily for display information (Name, Brief Description, Description, and Information 
URL). 


Property Description 


Name The name of the ACE, used to organize the rule in ConflictSolver. This is displayed in 
several places, including the Output window, the Rules Viewer Dialog, and the Conflicts 
tab of the Options Dialog. 
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Property Description 


Associated Table Select the table in the Application Catalog which will be queried in the user-defined ACE. 
This also determines which columns are available in the Expression Builder Dialog, and 
which tokens are available for the Error and Display strings on the Custom Options Panel 
of the Rules Wizard. 


Brief Description Enter a brief description which will be displayed in the Rules Viewer Dialog, the Conflicts 
tab of the Options Dialog, and in the Output window. This description should be clear 
enough so users can understand when to use this ACE. 


Description Enter a description of the ACE, which is displayed at the bottom of the Rules Viewer Dialog 
when the ACE is selected and in the Output window during conflict identification when the 
ACE executes. 


Information URL Provide a URL to get further information for the ACE. This URL appears in the Conflict 
Details area of the Conflicts View after conflicts have been identified. 


To continue editing ACE Properties, click the Additional Information, Custom Options, Where Clause, or DLL 
Information tabs. To save your edits and close this dialog, click OK. 


Additional Information Tab 


From the Additional Information tab, you can edit information for categorizing the ACE in relation to other ACEs in 
ConflictSolver. 


ACE Rule Properties 


General Information | Additional Information | Custom Options | Where Clause 


Additional information is necessary to categorize the ACE during conflict identification. 
Supply the required data for the following properties: 


Category: 
INI Files 


Rule Type: 
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Property Description 


Category Either select an existing category for this new rule, or enter the name for a new category. These 
categories are displayed in the Conflict View and the Conflicts tab of the Options dialog. Ideally, 
any user-defined ACEs should be put in their own category. 


Rule Type The Rule Type of this ACE is displayed (read only). 


a Custom - Source Only Packages ACEs allow you to quickly test any column or any value 
of a table. For example, you could use a user-defined ACE to identify packages that create a 
desktop icon. To define a user-defined ACE, you use an SQL "Where" clause. 


= Custom - Source and Target Packages ACEs allow you to compare columns or values 
of Source package tables (new packages that you want to install onto a user's system) to 
columns or values of Target package tables (packages already installed on a user's system). 
For example, you could use a Source and Target Packages ACE to determine if the installation 
of a Source package onto a Target system would produce duplicate registry entries. To define 
a Source and Target Packages ACE, you must define a SQL "Where" clause, and specify a 
Join Column (a table column in the Application Catalog database that has a matching value 
for both the Source and Target packages). 


= DLL- User Provided DLL based ACEs allow you to run more complex tests—testing many 
tables in any combination. For example, you could use a DLL-Based ACE to confirm that a 
source product language is the same as all target product languages. To define a DLL-Based 
ACE, you use SQL and other programming commands. With DLL-Based ACEs, you can use a 
Conflict Application Resolution Definition (CARD) to fix the conflict. 


Em To continue editing ACE Properties, click the General Information, Custom Options, Where Clause, or DLL 
Information tabs. 


m To save your edits and close this dialog, click OK. 
Custom Options Tab 
From the Custom Options tab, you can edit this ACE's display strings for the Output window and Conflict Details. 


ACE Rule Properties 


General Information || Additional Information Custom Options Where Clause 


Custom rules have specific display options which need to be specified. Supply the required 
data for the following properties: 


Error String: 


[etuoi] 


Display String: 
|[DefaultDir] 


Severity 
© Warning 
O Error 
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The following properties are included: 


Property Description 


Error String This string appears in the Output window when a violation of this ACE rule is detected 
during conflict identification. For example, if you were creating a user-defined ACE to 
identify packages that create a desktop icon, you could enter "Failure in creating desktop 
icon" in this field. 


4 


ne 


\ 
~ 


/ AN 
\ 
NG y 
Tokens allow you to insert values at run-time from the installation package into the string, 


such as specifying a file name. To use token replacement in the error string, use the arrow 
to the right of the Error String field. 


Display String This string appears in the Conflict Details area of the Conflicts View after conflicts have 
been identified. For example, if you were creating a user-defined ACE to identify packages 
that create a desktop icon, you could enter "Duplicate desktop icon found" in this field. 


A 


aN 
W Y 


Tokens allow you to insert values at run-time from the installation package into the string, 


such as specifying a file name. To use token replacement in the error string, use the arrow 
to the right of the Display String field. 


Severity Specify whether this ACE should be an Error or a Warning. 


Report 'No' results User-defined ACEs report conflicts based on the provided query. However, you may want 
to report the absence of the data if it could not be found. If you select this option, if the 
ACE does not return any results, it will be reported as an error (or warning), with the 
description and error strings as specified. If you expect a 'No' result, do not use tokens in 
your display or error strings. 


m To continue editing ACE Properties, click the General Information, Additional Information, or Where Clause 
tabs. 


m To save your edits and close this dialog, click OK. 
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Where Clause Tab 


From the Where Clause tab, you can edit the Where clause for the ACE. If you do not know how to build a Where 
clause, you can click the Build Expressions button to launch the Expression Builder Dialog. You can also click Test to 
validate the Where clause syntax. 


ACE Rule Properties 


General Information | Additional Information | Custom Options | Where Clause 


Custom ACEs require a SQL Where clause to operate. Enter a valid Where clause below, or 
use the Expression Builder to construct one. 


Where Clause: 
dddd [DefaultDir] > '70' 


Build Expression... 


If you selected Custom - Source and Target Packages when you created this ACE, you must have also selected a Join 
Column—a table column in the Application Catalog database that has a matching value for both the Source and 
Target packages. Rows in each of the packages that have a matching value in the Join Column are selected and those 
rows are checked against the Source and Target Packages. For example, if you wanted to evaluate records from two 
tables that have a installation directory of C:\ProgramFiles, then you would specify Directory as the Join column. To 
change the Join Column, select a different column name from the list. 


To improve query performance, enclose table names in square brackets ([]). 
m To continue editing ACE Properties, click the General Information, Additional Information, or Custom Options 


tabs. 


m To save your edits and close this dialog, click OK. 
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DLL Information Tab 


From the DLL tab, you can edit specific information about the ACE/CARD DLL file and the ACE and CARD 
Function Names that DLL-based ACEs require to operate. 


ACE Rule Properties 


General Information || Additional Information | DLL Information | 


DLL-based ACEs require specific information about the DLL and ACE function name to 
operate. Provide the requested information below. 


ACE/CARD DLL File: 
C:\AdminStudio Shared\Rumba_Marimba\nep4720a.dl 
ACE Function Name: 


x32 Test 
CARD Function Name (optional): 


The following properties are included: 


Property Description 

ACE/CARD DLL File Select the name of the ACE DLL that you are testing. 

ACE Function Name Enter the name that you chose to "export" for this ACE function. 

CARD Function Name Enter the name that you chose to "export" for this CARD function. 

Test Click the Test button next to the ACE Function Name or CARD Function name to validate 
that the exported function does exist. 


Em To continue editing ACE Properties, click the General Information or Additional Information tabs. 


m To save your edits and close this dialog, click OK. 
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Add Ignore Table Dialog 


This dialog allows you to specify a custom table to ignore during import of a package into ConflictSolver. You can 
also provide comments about the table. 


Add Ignore Table 


Table Name 


Comments 


Ignored tables will not automatically be imported when using the Import Custom Tables option in the Import Tab of 
the Options Dialog. 


Advanced Options Dialog 


The Advanced Options Dialog allows you to select custom tables that are not part of a standard Windows Installer 
package, and direct ConflictSolver to import them. Indicate which custom tables you want to import by selecting the 
check box next to the table name. You can also use the Select All and Clear All buttons to make selections. 


Advanced Options 


Custom Tables 


ISDistribution 


Add to Ignore List Select All Clear All 


Global Import Options... 


To add one of the listed tables to the Ignore Tables list on the Import Tab of the Options Dialog (so that it will not 
be imported into ConflictSolver during any import), select the table name and click Add to Ignore List. 


To set other global import options, click the Global Import Options button to access the Import Tab of the Options 
Dialog. 
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Associate with AMS Application Dialog 


© 


This is a snap-in feature available only with InstallShield AMS 2.0. 


The Associate with AMS Application dialog is displayed when you select the corresponding command from the 
context menu when right-clicking on a product. It allows you to associate extended attribute data for a product with 
an application already in InstallShield AMS 2.0. You can select the available packages from the list in the dialog. 


This dialog (and its corresponding command) are only available if you select the Integrate with AMS option on the 
Extended Attributes tab of the Options Dialog. 


Be sure to select an AMS application that uses a template containing at least one major data item that was specified 
with the group's extended attribute description file, as described in the InstallShield AMS 2.0 help. 


CARD Resolution Options Dialog 


Some CARDs can resolve a conflict in more than one way. For example, ACE06 checks whether the executable 
module within the component is the key file, and accumulates a list of potential files to be used for the key file. Any 
one of these files could be designated as the key file to resolve the conflict. 


If a CARD can be resolved in multiple ways, and if the Maximize user flexibility in selecting resolutions option is 
selected on the Resolution Tab of the Options Dialog, the CARD Resolution Options Dialog appears, prompting you 
to make a selection to determine how conflict resolution will proceed. 


CARDO6 - Resolution Options 


CARDO will update the 'DRYConflict' component 'KeyPath' field with your 
selection. 


Files 


FRAMEBUF.DRYV 
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Command-Line Parameters Dialog 


This dialog is displayed when running ConflictSolver from the command line using the -? parameter. Information in 
this dialog is covered in the Command Line Functionality topic. 


Conflict Information Dialog 


When you click on one of the informational links in the Summary section of either the Conflicts View or Conflict 
Resolution Dialog, the Conflict Information dialog appears, displaying information on the selected link. 


Conflict Information 


Products | ACE Rules | New Products 


Name Description 

PackageForT he\Web 4 Contact: Your local administrator | 
Norton Antivirus Corporate Edition Enter comments regarding this installation database here. 
Orca Contact: ‘Your local administrator 


For example, if you click on the ACE rule link, the Conflict Information dialog appears with the ACE Rules tab 
selected. 


The dialog contains the following tabs (which are only displayed if they have data): 


Tab Description 


Products The product(s) against which conflict identification was performed. The name, description, 
and any groups the products belong to are displayed. 


ACE Rules The category and description for each ACE rule used in conflict identification. 


Updated Products The name, description, and modification date of any relevant product that has been 
updated since the last conflict identification was performed. 


Deleted Products The name and description of any relevant product that has been removed from 
ConflictSolver since the last conflict identification was performed. 


New Products The name, description, and import date of any product that has been added to 
ConflictSolver since the last conflict identification was performed. 
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Conflict Resolution Dialog 


You can display the Conflict Resolution dialog either by running the Conflict Wizard and selecting the Run Resolution 
option in the Conflict Options Panel, or by selecting Resolve External Package Conflicts from the Conflicts menu 
after a previous conflict identification between an external package and products in ConflictSolver. 


Conflict Resolution 


Conflict Information | Summary ~ | 


Summary 


When conflict identification was performed on 'C:\AdminStudio Shared\Paint Shop Pro 7 Anniversary 
Edition.msi' on 'Monday, January 12, 2004 - 1:41 PM’, a total of 8 conflict(s) were identified, of which 4 are 
automatically resolvable, by checking a total of; 


using 25 ACE rule(s). 

None of these product(s) have been updated. 

None of these product(s} have been deleted. 

10 new product(s) have been added to the AdminStudio Application Catalog. 


Resolution Options 


The conflict resolution options for this package are to: 
Resolve Conflicts: Save the resolutions within a transform file. 
C:\AdminStudio Shared\Paint Shop Pro 7 Anniversary Edition2.mst 


You can modify these resolution options by selecting ‘Edit’. 


It is strongly recommended that you import packages into ConflictSolver prior to performing conflict identification, 
instead of running conflicts between an external package and products in ConflictSolver. 


Prom this dialog you can access information pertaining to the last execution of the Conflict Wizard. This persisted 
conflict data allows you to view when the last execution was performed, the products that it was run against, the ACE 
rules used, and conflicts discovered. The view also provides a list of updated, deleted, or added products that may 
necessitate performing conflict identification again. 
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Summary Information 


The main area of this view displays summary information for the last conflict identification execution. This includes: 


m The name of the product on which m The ACE rules used during conflict identification. 


eae eh idendicaton was pesonned: m The number of checked packages that have changed since 


m The date and time of the last conflict conflict identification. 
identification, m The number of checked packages that have been deleted 
m The number of conflicts detected. from ConflictSolver since conflict identification. 
m The number of detected conflicts which m The number of packages that have been imported into 
can be resolved automatically. ConflictSolver since conflict identification. 


m The products the current product was 
checked against. 


Links 


When you click on one of the informational links, the Conflict Information Dialog appears, displaying information on 
the selected link. For example, if you click on the ACE rule link, the Conflict Information dialog appears with the 
ACE Rules tab selected. 


Run Again 


Click Run Again to perform conflict identification on the package again, using the specified packages (if they still exist 
in ConflictSolver) and ACE rules. Because packages may have been removed or modified, conflict identification may 
return different results. 


Using the pull-down list at the top of the view, you can toggle between summary information and conflict-specific 
information. When you select a specific conflict type, the view changes to display a list of corresponding errors in the 
product, grouped by ACE. The icon displayed next to the conflict indicates its status: 


Icon Status 


2 Resolvable 


Q Resolved 


(x) Unresolvable 


In many cases, these errors can be resolved by clicking either Resolve or Resolve All. In cases where no automatic 


resolution is possible, the Unresolvable &@ icon appears next to the conflict and the Resolve button is disabled. 


If one of the following options on the Resolution tab of the Options dialog is selected, you several additional dialogs 
could appear prompting for approval or additional information for user input: 
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m= Ifthe Preview and approve all resolutions option is selected, the Resolution Details Dialog appears, listing 
the changes that are going to be made and prompting you to approve them. 


= Ifthe Maximize user flexibility in selecting resolutions option is selected, and if you are using a CARD 
with multiple resolution options, a list of options from you to choose from could appear the CARD Resolution 
Options Dialog, prompting you to select one. 


Por File Conflicts, click the plus sign next to the conflict icon to see the package that conflicts with the selected 
package. 


Conflict Details 
aR 
=) The file ‘Inetwh32.dll', version '1.10.1.1', in the component 'SystemHelpFiles 
PackageForTheWeb 4 v4.0.0 
SS acez3 
S] @ The file 'Inetwh32.dll’, size '48640' bytes, version '1.10.1.1', language 'Englis 
PackageForTheWwWeb 4 v4.0.0 


This section displays the current resolution option: either resolve in the original Windows Installer package, or using 
the specified transform. Click Edit to change the current settings on the Resolution Options Dialog. 


Customize Dialog 


The Customize Dialog box, which is accessed by selecting Customize from the Tools menu, allows you to customize 
which toolbars ate available in the ConflictSolver user interface, as well as the buttons that are available on the 
toolbars. The dialog box consists of two tab panels: 


Toolbars 


From the Toolbars panel, you can select viewing properties for all toolbars, such as whether tooltips are displayed, the 
style of the toolbar, and the size of the buttons. You can also create your own custom toolbar, onto which you can 
place buttons found in the Command tab. 


Customize 


Toolbars | Command 


Toolbars: 


VEC) M Show Tooltips 
|" ]Standard | F] Cool Look 
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The Command panel allows you to customize toolbars and the menu bar. Drag the command or menu you want to 
add to the existing toolbar; it appears where you place it. To remove a command or menu, select it and drag it off the 
toolbar. 


Customize 


Toolbars | Command 


Categories: Buttons 


Cals E: ONS 


Menu 


| 
| eai a ae 


Select a category, then click a button to see its description. Drag the button 
to any toolbar 

Description 

Resolve conflicts 


Expression Builder Dialog 


The Expression Builder dialog, available by clicking Build Expression on the Where Clause Panel in the Rules Wizard 
(when creating a new user-defined ACE) or from the Where Clause Tab of the ACE Rule Properties Dialog (when 
editing a user-defined ACE), allows you to build simple Where clause expressions for ConflictSolver user-defined 
ACEs. 


Expression Builder 


Table Columns 


Comparison Operator 


Constant 


Expression Operator 
AND OR 
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Set values for the following properties: 


Property Description 


Table Columns This list is populated from the table columns in the table defined in the Rules Wizard 
General Information Panel. Select the table column used in this Where clause. 


Comparison Operator Pick an operator to use for comparison in the Where clause. You can pick from the 
following: 
= (Equal To) 
<> (Not Equal To) 
> (Greater Than) 
< (Less Than) 
>= (Greater Than or Equal To) 
<= (Less Than or Equal To) 
Constant This constant can be a numerical value or string value. The property label will change 


based on the expected constant type. This value is compared against the data in the 
specified table. 


When using the Expression Builder Dialog to create a Source and Target Packages custom 
ACE to compare the value of a column in the source table to the value of a column in the 
target table, you can select the first table column name from the Table Columns list. 
However, you have to manually enter the second table column name in the Constant text 
box. When doing so, enter the table column name using the same syntax that is used in the 
Table Columns list: [Source].[ColumnName] or [Target] .[ColumnName]. 


Expression Operator If there is more than one expression in the Where clause, you can specify an operator to 
join the current expression to the previous expression. 


When you are constructing simple expressions, it is helpful to use the Expression Builder dialog, but you are not limited 
to the formatting options that the Expression Builder provides to you. If you know how to write Where clauses in SQL, 
you can use significantly more powerful expressions by entering them directly in the Where Clause text box on the 
Where Clause Panel of the Rules Wizard or on the Where Clause Tab of the ACE Rule Properties Dialog. 
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Extended Attribute Property Dialog 


If you use extended attributes in ConflictSolver, and you click on a text extended attribute label, this dialog appears. 


Extended Attribute Property 


Application Type 


| General v 


The Application Type is one selected From a list of possible application 
types, Please select the most appropriate Application Type, even though 
more than one may apply. 


Within it, you can provide the value for the extended attribute. When you click OK, the value is automatically 
displayed in the Extended Attributes view next to the corresponding label. 
Find Dialog 


You can use the Find Dialog, which is accessed by selecting Find from the Edit menu, to search for data in 
Application Catalog tables. 


Find in Package ‘PackageFor TheWeb 4 (4.0.0)' 


Find What: BeppSearch] 


Look In Table: | <All Tables > 
f 
| 


Look In Column: | <All Columns> 


[_] Partial Match 


The tables that are searched depend upon what is selected when the Find dialog is opened: 


If you select... and specify these options... this will be searched 


Group All Tables and All Columns All tables and all columns in all of the Packages in the 
selected Group 


Package All Tables and All Columns All tables and all columns in the selected Package 

Package A table and All Columns All columns of a specific table in the selected Package 

Package A table and a column A specific column in a specific table in the selected 
Package 


Also, if you want to search for a partial match rather than an exact match, you can use the Partial Match option on the 


Find dialog. 
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The Find dialog can be accessed in four ways: 


E Select Find on the Edit menu. 


m Type Ctrl + F. 


-| 
m Click the Find & Mutton on the toolbar. 


E Select the node in the tree (Group, MSI Package, OS Snapshot, Other Setup, etc.) that you want to search, and 


select Find from the context menu. 


The Find dialog contains the following fields and buttons: 
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Field Description 
Find Enter the text that you want to search for. 
What 


Columns list is populated with all of the columns in that table. 


Look In If a Package was selected when the Find dialog was opened, all of the tables in that Package are listed. Select 
Table the table that you would like to search, or select All Tables. When you select a table from this list, the Look In 


If a Group is selected when you opened the Find dialog, All Tables is the only option listed. 


Columns that you would like to search, or select All Columns. 


Look In If you selected a table from the Look in Table list, all of the columns in that table are listed. Select the column 


If a Group was selected when you opened the Find dialog, All Columns is the only option listed. 


Match What text box. The search will be case sensitive. 


match is performed. The search will be case insensitive. 


Partial If this option is not selected, ConflictSolver will search for an exact match of the text you entered in the Find 


If this option is selected, then ConflictSolver will use appropriate wild card characters so that a partial data 


Button Results tab of the Output window, in the following format: 


17 occurrences) of ‘AppSearch’ have been found. 


2 csmsiActionText Action 
csmsiActionText Action 


2 
2 csmsiActionText Action 
2 csmsisy¥s Validation Table 


141 4 | > [> Output A Import A Validate A, Conflicts A Subscription A, Search Results 


that record will be highlighted in red. 


Package Name Package RowID Table RowID Table Name Column Name 


Find Click to initiate the search. The Find dialog will close, and the data that is found is displayed in the Search 


Column Data 


AppSearch 
AppSearch 
AppSearch 
AppSearch 


If you double click on this data, ConflictSolver will navigate to the appropriate record in the Tables View, and 
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Group Properties Dialog 


The Group Properties Dialog opens when you right-click a group in the Groups tree and select Properties from the 
context menu. 
Group Properties 


Name: T 


Description: 


Comments: 


You can provide both a name and description for the group, as well as any comments. Information provided in this 
dialog is displayed in the Properties area of the Group view (displayed whenever a group is selected in the main 
products explorer). 


Option Description 

Name Provide a name for the group. This name cannot exceed 40 characters. 

Description Enter any descriptive information about the group. This cannot exceed 80 characters. 

Comments Provide any comments about the group. Comments cannot exceed 255 characters in 
length. 
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Options Dialog 


The Options dialog, accessible by selecting Options from the Tools menu, provides a way to configure how 
ConflictSolver handles validation and conflict identification, as well as some general settings. 


Conflicts Tab 
From the Conflicts tab of the Options dialog, you can configure the following options: 


Options 


Extended Attributes ala Duplicate Package , 7 
General || Import | Validate || Resolution | Conflicts 


Suppress 


Dw amings C Info 


Predefined and Custom ACE Rules 
= WE Conflict Types 

J) Components 
JG File Extensions 
H-E Files 
Me INI Files 
i NT Services 
a- C6 ODBC Resources 
a- Product Properties 
OG Registry 
(i) Shortcuts 


Custom ACE Rule File 
C:\AdminStudio Shared\ConflictS olver\CustomConflictFile. ace | Browse... 


Property Description 
Suppress When these boxes are checked, the messages of that type will not be displayed in the 
Wanrnings/Info Conflicts tab of the Output window during conflict identification. It is strongly 


recommended you do not suppress warning messages so you can ensure proper conflict 
identification. 


Conflict Types If you want a specific type of conflict identified by default, select the appropriate check 
box. Conflict rules (ACEs) associated with unselected boxes will not be performed by 
default during conflict identification. However, you can override these in the Conflict 
Options Panel of the Conflict Wizard. 
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Property Description 


Custom ACE File The user-defined ACE file specified here is run after the pre-defined ACE rules are run. The 
selection of this user-defined ACE file will affect the default Conflict Types displayed on this 
dialog (described above), as well as those displayed on the Rules Viewer and the Conflict 
Wizard. 


By default, a file path to an initially empty user-defined ACE file is provided for you. If you 
have already created a user-defined ACE, specify the location of that user-defined ACE file 
to activate it. Only one user-defined ACE file can be active at one time. 


You use user-defined ACEs to extend the functionality of pre-defined ACEs with company- 
specific functionality. By selecting different user-defined ACE files, you can organize rules 
appropriate for individual users in your organization. See User-Defined ACEs for more 
information. 


Duplicate Package Tab 


When you import a package into the ConflictSolver Application Catalog database, ConflictSolver checks specific 
identifiers that are selected on the Duplicate Package Tab to determine if that package has already been imported. 


Options 


General Import Validate Resolution || Conflicts 
Extended Attributes | Duplicate Package 


C] Product Language 
C] Product Version 
List of Transform Files 


If ConflictSolver determines that you are attempting to import a duplicate package (based upon the selected 
identifiers), the Product Name Change Dialog appears, where you are given the opportunity to enter a name of your 
choosing to identify the duplicate package before the package is imported. 
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E Product Name Change 


The duplicate package detection process has identified this package as a 
duplicate of another package. By specifying a unique product name, you 
can proceed with the package importation. 


Product Name 


| Microsoft Corporation _Orca i i ] 


If ConflictSolver is performing a bulk import or reimport, it still identifies duplicate packages using the user-specified 
criterion. However, ConflictSolver will generate a unique displayed product name and allow the import to proceed 
without prompting the user. 


The identifiers you can select on the Duplicate Package Tab are as follows: 


Property Description 


PackageCode Property Identifier of package product was installed from. No two non-identical .msi files should 
ever have the same package code. 


ProductCode Property Unique identifier for the particular product release, represented as a string GUID, for 
example {12345678-1234-1234-1234-12345678901 2}. 


Product Language The language the installer should use for any strings in the user interface that are not 
authored into the database. 


ProductVersion Version of the product in string format. The format of the string is: major.minor.build. 
List of Transform Files A list of the transformations associated with this package import operation. 
[None Selected] If you do not select any of these five identifiers, ConflictSolver checks the ProductName 


Property identifier to determine if a package is a duplicate. 


When it identifies a duplicate package, ConflictSolver generates a new name for that package by pre-pending the 
Product Name with the Manufacturer's name and, if necessary, appending the Product Name with numbers: 


Ist Package: Powerpoint 
2nd Package: Microsoft Corporation_Powerpoint 


This generated name is displayed on the Product Name Change Dialog, and it is the name that will be displayed in the 


product tree on the left side of the ConflictSolver Main View. However, changing this "display" name does not change 
the ProductName Property that appears in the title bar in of the ConflictSolver Product View. 
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Example of Importing a "Duplicate" Package 


One common reason why you might want to import the same package into your Application Catalog database more 
than once would be if you wanted to use AdminStudio Tuner to create custom installation SKUs of a common MSI 
package to distribute to different departments in your organization, each installation including certain features that are 
appropriate for the department and excluding certain features that are not appropriate. For example, if you were 
distributing a copy of Microsoft Office, you could add transforms to the Microsoft Office MSI package so that: 


m Accounting's installation would include only Word and Excel 
m Marketing's installation would include only Word and PowerPoint, and 


m Development's installation would include only Word and Access. 


Therefore, you might want to import the same package into your database more than once, each time with a different 
set of transformations. What happens when you import the package the second time depends upon the identifiers you 
selected on the Duplicate Package Tab. In this example: 


m If you select the List of Transform Files and ProductCode identifiers on the Duplicate Package Tab of the 
Options dialog, ConflictSolver will not identify these two packages as duplicate, even though they have the same 
ProductCode, because they have a different set of transformations. Therefore, the Product Name Change dialog 
will not appear, and the package will be imported with the same display name as the first package. 


m If you only select the ProductCode identifier on the Duplicate Package Tab of the Options dialog, ConflictSolver 
will identify the second package as a duplicate because the two packages have the same ProductCode, and the 
Product Name Change dialog will appear. 


The options that you select on the Duplicate Package Tab of the Options dialog apply globally to all packages that you 
attempt to import; you cannot apply different identifiers to different packages. Also, since these options are saved in the 
AdminStudio Shared Directory, everyone using AdminStudio at your organization who shares the same directory will 
share the same Duplicate Package options. 
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Extended Attributes Tab 


From the Extended Attributes tab of the Options Dialog, you can specify the name and location of the extended 
attribute description file (.xml) which specifies the extended attributes available for each package in ConflictSolver. 


Options 


General Import Validate | Resolution I Conflicts 
Extended Attributes Duplicate Package 


Extended Attribute Description File 
IC:\AdminStudio Shared\EA, Default.xm 


L 


Integrate with AMS 


AdminStudio includes a default XML file for extended attributes, which is stored in the AdminStudio shared location. 
You can also construct your own extended attribute description file. Each new Application Catalog automatically 
points to this file, and displays the name and location of the file in this tab. 


You can also configure ConflictSolver to integrate with InstallShield AMS 2.0 by selecting the corresponding option. 


If you overwrite the default XML file with your extended attributes data, all subsequent Application Catalogs created include your 
attributes by default. 
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General Tab 
From the General tab of the Options Dialog, you can configure the following options: 


Options 


Extended Attributes af Duplicate Package 
Import | Validate || Resolution || Conflicts 


Report Location 


[m Files\InstallShield\AdminStudio\5. 5\ConflictS olver\R eports'\Standard | PR) 


Options 

C Confirm All Drag-Drop Operations 

[¥] Display Broken MSI/MST Package Links 
C] Only Display View Nodes with Data 


OS Snapshot Display Limits 
100 Records 


Option Description 


Report Location ConflictSolver searches the directory specified for reports that appear under the 
Reports menu. You can directly enter the path, or use the Browse button (...) to 
specify it. Reports must be in Crystal Report (.rpt) format. 


Confirm All Drag-Drop Select this option if you want ConflictSolver to prompt you for confirmation whenever 
Operations you drag and drop items. 

Display Broken MSI/MST When selected, any broken package links will be indicated by an icon change in 
Package Links the products explorer, and with a message in the Products view, which allows you to 


attempt to locate the package. 


Only Display View Nodes When this option is selected, packages containing views without data will not 
With Data display those views. For example, if a package has no shortcuts, then the Shortcuts 
view is not displayed for that package. 
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Option Description 


OS Snapshot Display Limits The value entered in this field sets the limit for the number of records of OS Snapshot 
data that is displayed in ConflictSolver in the Files View, INI Files Changes View, 
and Registry View of an imported OS Snapshot. Since some OS Snapshots contain 
a very large number of records, this field is provided to you to enhance performance 
of the display views. When you have reached the limit of the data display, a 
message will appear in the Status Bar informing you that the display has been 
truncated and lists how many records were not included in the display results. For 
example: 


An additional xxxxxx records were not included in the display 
results to improve performance. 


This field limits the amount of data displayed in the display views, not the amount of 
data that is stored in the OS Snapshot. To display all of the records in one of these 
display views, increase the OS Snapshot Display Limits value by the amount of 
records that were truncated. Please note that ACE23 and ACE24 (ACEs that run 
against OS Snapshot data) will work properly no matter how much data is displayed 
in the display views. 


Import Tab 


From the Import tab, you can configure several options that affect how packages are imported into ConflictSolver. 
Most of these options can be overridden on a package-by-package basis; these options serve as the defaults. 


Options 


r Extended Attributes me Duplicate Package 
General | Import | Validate || Resolution E Conflicts 


Options 


Import Binary Data 
Import Custom Tables 
C] Abort on Fatal Error 


Ignore Tables 


Table Name Comments 
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You can configure the following options: 


Option Description 

Check for Validation By default, packages will by default be checked for validation errors on import. 

Errors 

Check for Conflicts The Conflict Wizard, by default, will run following import. 

Import Binary Data Binary data in the package will be imported. 

Import Custom Tables By default, custom Windows Installer tables will be imported into ConflictSolver. Tables 
specified in the Ignore Tables list will not be imported. 

Abort on Fatal Error Select this option to stop instruct ConflictSolver to stop import if a fatal error occurs. Fatal 
errors include loss of network connection or running out of space. Non-fatal errors include 
duplicate packages or merge modules or data truncation. 


Ignore Tables List 


The Ignore Tables list displays all of the tables that will be ignored during import (not imported into ConflictSolver). 
You can select tables and delete them from the list, or you can add new tables to the list by clicking Add (which 
displays the Add Ignore Table Dialog). 
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Resolution Tab 


On the Resolution Tab of the 
performed. 


Options 


Extended Attributes 
General Import Validate 


Initial Resolution Location 


Resolution Options 


Preview and approve all resolutions 


Options Dialog, you can specify options to determine how conflict resolutions are 


Duplicate Package 


Resolution Conflicts 


Maximize user flexibility in selecting resolutions 


The Resolution Tab contains t 


he following properties: 
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Property 


Description 


Perform resolutions 
against a transform 
file 


If this option is selected, ConflictSolver will, by default, save conflict detection resolutions in 
a transform file (MST). The original Windows Installer package (MSI) remains untouched. 


You can override this option for an individual package by going to that package's Conflict 
View and clicking Edit and change this option on the Resolution Options Dialog. 


Preview and approve 
all resolutions 


Select this option if you want to review and approve the suggested resolution for each 
conflict before ConflictSolver performs any resolutions. When the conflict detection process 
is completed, the Resolutions Details Dialog is displayed, listing the conflicts that were 
found and the CARDs that could be used to resolve these conflicts. Before ConflictSolver 
will continue resolving these conflicts, each conflict resolution must be approved. See 
Conflict Resolution Process for more information. 


Maximize user 
flexibility in selecting 
resolutions 


Some CARDs can resolve a conflict in more than one way. For example, ACEQ6 checks 
whether the executable module within the component is the key file, and accumulates a list 
of potential files to be used for the key file. If this option is selected, this list of files is 
displayed on the CARD Resolution Options Dialog, and you are prompted to select which 
file to use. If this option is not selected, the CARD will perform its default resolution. 
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Validate Tab 
Prom the Validate tab of the Options dialog, you can configure the following options: 


Options 


Extended Attributes Duplicate Package 
General || Import Validate Resolution || Conflicts 


Suppress 


LF Wamings Cl info 


MSI Input files 
Cub File: C:\Program Files\InstallS hield\AdminS tudio\5. 5\Conflict| fag) 


ICE Rules: | 


MSM Input files 
Cub File: [C:\Program Files\InstallShield\AdminStudio\.5\Confii | (...] 


ICE Rules: | 


Separate multiple ICE rules with a semicolon (;). 


Option Description 
Suppress When these boxes are checked, the messages of that type will not be displayed in the 
Wanrnings/Info Validate tab of the Output window during validation. It is strongly recommended you do 


not suppress warning messages so you can ensure proper validation of packages before 
importing them into ConflictSolver. 


MSI Input Files There are two options that you can configure for MSI input files: 


= CUB File—The file specified in this field is file containing Internal Consistency 
Evaluators (ICEs) used for validation. Either enter the location of this file directly, or use 
the Browse button (...) to locate it. 


= ICE Rules—By default, ConflictSolver uses all ICEs contained in the default CUB file 
during validation. To run specific ICEs, enter them in this field, separated by semicolons 
(;) if there are multiple ICEs. 


MSM Input Files There are two options that you can configure for merge module input files: 


= CUB File—The file specified in this field is file containing Internal Consistency 
Evaluators (ICEs) used for validation. Either enter the location of this file directly, or use 
the Browse button (...) to locate it. 


a ICE Rules—By default, ConflictSolver uses all ICEs contained in the default CUB file 
during validation. To run specific ICEs, enter them in this field, separated by semicolons 
(;) if there are multiple ICEs. 
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Product Name Change Dialog 


This dialog appears when you are attempting to import a package that has been identified as a duplicate to a package 
already in the ConflictSolver database—based upon the identifiers you have selected on the Duplicate Package Tab of 
the Options dialog (PackageCode, ProductCode, Product Language, ProductVersion or List of Transform Files). 


E Product Name Change 


The duplicate package detection process has identified this package as a 
duplicate of another package. By specifying a unique product name, you 
can proceed with the package importation. 


Product Name 


| Microsoft Corporation_Orca 


You might encounter this situation if you are importing the same package into the ConflictSolver database multiple 
times, each time with a different set of transformations. One common reason why you might want to import the same 
package into your Application Catalog database more than once would be if you wanted to use AdminStudio Tuner to 
create custom installations of a common MSI package to distribute to different departments in your organization, 
each installation including certain features that are appropriate for the department and excluding certain features that 
are not appropriate. For example, if you were distributing a copy of Microsoft Office, you could add transforms to the 
Microsoft Office MSI package so that: 


m Accounting's installation would include only Word and Excel 
m Marketing's installation would include only Word and PowerPoint, and 


m Development's installation would include only Word and Access. 


When it identifies a duplicate package, ConflictSolver generates a new name for that package by pre-pending the 
Product Name with the Manufacturer's name and, if necessary, appending the Product Name with numbers: 


Ist Package: Powerpoint 
2nd Package: Microsoft Corporation _Powerpoint 


This generated name is displayed on the Product Name Change Dialog, where you are given the opportunity to either 


accept this generated name or enter a name of your choosing to identify the duplicate package before the package is 
imported. Click OK to begin the import. 


As soon as you click OK on the Product Name Change Dialog, the package will be imported. If you want to cancel the 
import, click Cancel on this dialog. 
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@ 


If ConflictSolver is performing a bulk import or reimport, it still identifies duplicate packages using the user-specified 
criterion. ConflictSolver will generate a unique displayed product name and allow the import to proceed without 
prompting the user. 


(S) 


ConflictSolver identities duplicate packages based upon the identifiers that you selected on the Duplicate Package Tab 
of the Options dialog. See Specifying Duplicate Package Identifiers for more information. 


The name that is entered on the Product Name Change Dialog is the name that will be displayed in the product tree on 
the left side of the ConflictSolver Main View. However, changing this "display" name does not change the Product 
Name that appears in the title bar in of the ConflictSolver Product View. 


Remote Application Catalogs Dialog 
Displays all the application catalogs that are currently subscribed to. 


Remote Application Catalogs 


Remote Application Catalogs: 
| Server Application Catalog 


Remove 


Properties 


Click Add to access the Remote Package Alert Wizard, where you can subscribe to a new application catalog. To 
delete a link to a remote package, click Remove. 


Click Properties to access the Remote Package Alert Properties Dialog, where you can link/unlink to different 
packages, and can also specify the way linked packages will be refreshed. 
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Remote Package Alert Properties Dialog 


The Remote Package Alert Properties Dialog is accessed by clicking Properties on the Remote Application Catalogs 
Dialog. 


Groups Tab 


The Groups tab of the Remote Package Alert Properties Dialog displays the packages within a remote Application 
Catalog that you can link to. Select or deselect the checkboxes to link/unlink to the packages. Any package that is 
already linked to will display the checkbox as selected. 


Remote Package Alert Properties 
Groups | Options | 


SROI] Groups 

OR ACEO6Conflict v1.00.0000 

C1 ACETests 

a- OG Adobe 
OE DemoPlayer v1.00.0000 
ge InstallShield AdminStudio v5.01 
(LIA) McAfee VirusScan v4.5.0 
gA Nartco_ACEO6 Two v1.00.0000 
OG OmniPage Pro 10.0 ¥10.0.0.0 
PackageForTheWeb 4 v4.0.0 
OG PackageForTheweb 4 v4.0.0 

cH) Patch 

-EG Subscribed 
gA Symantec Act! v4.0.0 

H- Transforms 


a | ee | | 
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Options Tab 


The settings on the Options tab directly affect the way linked packages will be refreshed (update the contents of 
packages on your local Application Catalog with packages on remote Application Catalogs). 


Remote Package Alert Properties 
Groups | Options 


Refresh Options 


Mi 


Delete package when the source package is deleted 
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Option 


Description 


Update package when 
its source is modified 


If you have selected this option, when you select Refresh under Remote Package 
Alert on the Catalog menu, ConflictSolver will go and check if any of the linked packages 
have been modified in the Application Catalog. 


a If the linked package has been modified, then the local Application Catalog database 
is updated to reflect the changes. 


a If the linked package has not been modified, you receive a message stating that "No 
refresh is necessary". 


If you have not selected this option, when you select Refresh under Remote Package 
Alert on the Catalog menu, ConflictSolver will still check to see if any of the linked 
packages have been modified: 


a If the linked package has been modified, ConflictSolver will inform you that the source 
package has been modified but that it will not update the local Application Catalog 
database because this option is not selected. 


= If the linked package has not been modified, you receive a message stating that "No 
refresh is necessary". 


Delete package when 
the source package is 
deleted 


If you have selected this option, when you select Refresh under Remote Package 
Alert on the Catalog menu, ConflictSolver will delete any linked data in the local database 
if the data is deleted from the remote database. 


If you have not selected this option, when you select Refresh under Remote Package 
Alert on the Catalog menu, even if the source package is deleted in the remote database, 
your copy of the package will not be deleted. 
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The Resolution Details Dialog, which appears when you click Resolve or Resolve All on the Conflicts View, lists the 
proposed CARD resolutions that will be made to the package. Select the CARD resolutions that you want to execute 
and click Approve. 


Resolution Details 


The CARD resolutions will execute the following changes to the package. Please approve the 
changes before the resolution process can be completed. 


CARD Details 


Information Details 
Socarpi9 Update the 'ProductCode' property with a newly generated GUID, 
Secarp20 Update the 'UpgradeCode' property with a newly generated GUID. 


[C] Don't show this dialog again 


If you want to see the precise instructions that will be executed by a CARD during the resolution process before you 
approve it, select a proposed CARD resolution and double-click to access the Resolution Operations Dialog. 


The Resolution Details Dialog only appears if the Preview and approve all resolutions option is selected on the 
Resolution Tab of the Options Dialog. If this option is not selected, this dialog does not appear. If you do not want this 
dialog to appear, select the Don't show this dialog again checkbox on the dialog. This is equivalent to unselecting the 
Preview and approve all resolutions option on the Resolution Tab of the Options Dialog. 


Resolution Operations Dialog 


This dialog shows the selected CARD that is being executed, and the precise instructions that will be executed by the 
CARD during the resolution process. 
Resolution Operations 


CARD20 Operations 
UPDATE Property SET “Value” = '{26CCE02C-36FE-40B9-9110-1COCB85D0030}' WHERE *Property* = ‘Ur 


Click Close to exit this dialog. 
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Resolution Options Dialog 
From this dialog, you can specify the resolution method. 


Resolution Options 


Save Options 


O Save resolutions in original MSI package 


© Save resolutions in a new transform file 


| C:\AdminStudio Shared\PackageForTheWeb 4i.mst | 


Field Description 

Save resolutions in Select this option if you want to save conflict detection resolutions in the existing Windows 

original MSI package Installer package. 

Save resolutions in a Select this option if you want to save conflict detection resolutions in a transform file. In the 

new transform file text box, specify the name and location for this transform file or click Browse and select the 
transform file location. 


This dialog is accessible through the Conflicts View and from the Conflict Resolution Dialog by clicking Edit in the 
Resolution Options section. 


Rules Viewer Dialog 


The Rules Viewer dialog, accessible by selecting Rules Viewer from the Conflicts menu, allows you to view the current 
categorization of ACEs used for conflict identification. More importantly, it allows you to access the Rules Wizard to 
include user-defined ACEs in ConflictSolver. 


Rules Viewer 


Rules 


E E Conflict Types 

4) Components 

H- File Extensions 

H- Files 

B- INI Files 
4 short ACE description displayed when selecting an ACE to execute, 
ACE14 - Confirm that a INI files exist in only one component 
ACE21 - Check INI file entries From the IniFile table in the File table 
4CE22 - Check INI file entries From the File table in the IniFile table 

H- NT Services 

4) ODBC Resources 

(#5) Product Properties 

H- Registry 

-E Shortcuts 


4 description of the ACE displayed during ACE execution. 


The primary window in the Rules Viewer dialog displays a tree view containing each available ACE, grouped by 
category. If you click New, the Rules Wizard launches, allowing you to configure information for a new ACE. 


InstallShield Software Corporation © 2004 931 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


When a user-defined ACE is selected on the Rules Viewer dialog, the Edit button is enabled. When you click Edit, the 
ACE Rule Properties Dialog appears, where you can reconfigure the ACE. You can also delete user-defined ACEs by 
selecting them and clicking Delete. 


Wizards 


Conflict Wizard 


Although a Windows Installer package or merge module may be built to guidelines put forth by Microsoft, it is 
possible that the interaction between packages, or between a package and the base operating system, may cause 
unwanted results in your production environment. You can use the Conflict Wizard to identify these conflicts before 
you deploy packages, and resolve the problems before they affect your end users. 


The Conflict Wizard allows you to identify conflicts between a Windows Installer package and packages already 
cataloged in ConflictSolver. You can check for a variety of conflict types, including file, component, and registry 
conflicts. In many cases, ConflictSolver can resolve the issues automatically. You can also create your own custom 
rules to ensure packages conform to your internal standards and practices. ConflictSolver has rules to detect conflicts 
involving: Components, Files, Registry Entries, Shortcuts, INI Files, ODBC Resources, NT Services, File Extensions, 
and Product Properties. 


When run, ConflictSolver displays the output report in the Conflicts tab of the Output Window. 


Welcome Panel 
The first panel of the Conflict Wizard welcomes you to the Wizard. 


Conflict Wizard 


Welcome to the Conflict Wizard 


The Conflict Wizard allows you to check For conflicts 
between an external Windows Installer package and 
other packages already stored in the AdminStudio 
Application Catalog. 


Click Next to continue. 
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This panel, and others in the Wizard, have four buttons located at the bottom of the Wizard. Depending on where 
you are in the Wizard, certain buttons may be disabled. The buttons are: 


Button Description 

Next Advances you to the next panel in the Wizard. 

Back Moves you to the previous panel in the Wizard. 
Cancel Terminates the Wizard. 

Help Brings up help about the specific Conflict Wizard panel. 


Source Type Panel 


From the Source Type panel, select whether you want to compare an external Windows Installer package against 
packages already in the ConflictSolver Application Catalog or perform a comparison between packages within the 
ConflictSolver Application Catalog. 


Conflict Wizard 


Source Type 
Specify the source type. 


Select whether the source package is stored externally or within the Application Catalog. Click 
Next to continue, 


© a 


Check for conflicts between packages within the AdminStudio Application Catalog. 


O Windows Installer package 


Check for conflicts between packages in the AdminStudio Application Catalog and 
external MSI file, 


i It is Faster to perform conflict detection between internal application packages 


than it is to check against an external Windows Installer package. To improve 
performance, run conflict detection between internal packages 


m If you select Internal Application Catalog package, the next panel that appears is the Source Package panel. 


mE If you select Windows Installer package, the next panel that appears is the MSI Source Information Panel. 
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From the MSI Source Information Panel, specify the Windows Installer package you want to check for conflicts 
against packages already in ConflictSolver. 


Conflict Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Specify a Windows Installer package (.msi) and any associated transforms (.mst). Click Next 
to continue, 


Select an MSI file: 


| 
Transforms (mst): pal [x l t | + | 


Transforms area. Use the Browse button (...) to locate the transform. If the package requires multiple transforms, you 
can repeat the procedure as necessary. The order in which transforms are applied can be changed by selecting a 


transform and clicking $| (Move Up) and +| (Move Down). Delete a transform file from the Transforms list by 
selecting the transform and clicking x| (Delete). 
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Source Package Panel 


When you select the Internal Application Catalog package option on the Conflict Wizard Source Type Panel 
(specifying that you want to compare source packages from within the ConflictSolver database), the Source Package 
panel appears. 


Conflict Wizard 


Source Package 
Specify the source package. 


Select a source package to analyze For conflicts and click Next to continue. 


ERIE] Groups 
i=) Orca v1.50,.2600,0000 
PackageForTheWeb 4 v4.0.0 


This panel displays the packages in the same hierarchy as the products explorer. For your convenience, empty groups 
are not displayed on the products explorer. 


The ConflictSolver supports multiple source package checking. Therefore, select the package(s) you want to analyze 
for conflicts. If you select multiple source packages, ConflictSolver will conflict check each source package serially 
against all of the selected target packages. 


The target packages are specified on the next panel, the Target Information Panel. The Target Information panel will 
naturally exclude all packages that you selected on the Source Package panel. 


You can also select all packages in ConflictSolver or clear all selected packages using the Select All and Clear All 
buttons. 


Since the Target Information panel excludes all packages that are selected on the Source Package panel, exercise 
caution when using the Select All button. If you select all of the packages on the Source Package panel, there will be no 
target packages listed on the Target Information Panel, and therefore you will not be able to run conflict detection. 
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Target Information Panel 


In the Target Information Panel, select the individual packages or groups of packages in ConflictSolver that you want 
to compare the source package(s) against. 


Conflict Wizard 


Target Information 
Specify the target products, 


Select the groups or products against which you want to compare the source package for 
conflicts, Click Next to continue, 


=) Me Groups 

VIGA InstallShield Software Corporation_PackageForThewWeb 4 v4.0.0 
MP, orca v1.50.2600.0000 

MI PackageForTheWeb 4 v4.0.0 


Each package selected will be compared against the packages you specified in the Source Package Panel (for internal 
comparisons) or MSI Source Information Panel (for comparisons with an external Windows Installer package). 


The Target Information panel excludes all packages that you selected on the Source Package panel. Empty groups are 
also excluded. 


You can also select all packages in ConflictSolver or clear all selected packages using the Select All and Clear All 
buttons. 
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Conflict Options Panel 
In the Conflict Options panel, select the types of conflicts to use for conflict evaluation. 


Conflict Wizard 


Conflict Options 
Specify the conflict options. 


Select the conflicts to detect and click Next to continue. 
a E6 Conflict Types 

aC Components 
w- File Extensions 
(i) > Files 

(© INI Files 

E NT Services 

E ODBC Resources 

(© Product Properties 

(© Registry 

{© Shortcuts 


@) 


| B-B-e 


: [Generate Reports 


Depending on the conflict type selected, certain conflict rules are executed. 


Conflict Type Associated Rules 

Component ACEO2, ACEO4, ACEO5, ACEO6, ACEO9 
Files ACEO3, ACEO7, ACEO8, ACE12, ACE23 
Registry ACE10, ACE24 

Shortcuts ACE13 

INI Files ACE14, ACE21, ACE22 

ODBC Resources ACE15 

NT Services ACE16 

File Extensions ACE17 

Product Codes ACE18, ACE19, ACE20 
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Several options can be selected on this panel: 


Field Description 


Run Resolution Select to display the Conflict Resolution Dialog after conflict detection. From the Conflict 
Resolution Dialog, you can access information pertaining to the last execution of the 
Conflict Wizard. This persisted conflict data allows you to view when the last execution 
was performed, the products that it was run against, the ACE rules used, and conflicts 
discovered. The dialog also provides a list of updated, deleted, or added products that 
may necessitate performing conflict identification again. 


Generate Reports Select this option to generate a conflict detection analysis report containing a summary of 
the conflicts that were detected, and a detailed description of each identified conflict 
including how this conflict will be resolved. 


The default settings in the Conflict Options panel reflect the settings in the Conflicts tab of the Options Dialog (available 
from the Tools menu). 


Summary Panel 


The Summary panel provides a detailed summary of the options that were selected in the previous panels of the 
Wizard. 


Conflict Wizard 


Summary 
Review the conflict options, 


Source: 
C:\AdminStudio Shared\Orca.msi 


Checking for conflicts against: 
InstallShield Software Corporation_PackageForTheWeb 4 (4.0.0) 
Orca (1.50.2600.0000) 
PackageForThewWeb 4 (4.0.0) 


Conflict Selection Information: 
ACEO3 
ACEO? 
ACEO8 
ACE12 
ACE14 
ACE21 


arran 


Click Finish to identify conflicts, 


Click Finish to run the Conflict Wizard using the options specified. 
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Import Wizard 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


The Import Wizard allows you to import the following installation package types: 


Windows Installer (.msi) 
Transforms (.mst) 
Patches (.msp) 

Merge Modules (.msm) 
OS Snapshots (.osc) 
Marimba NCP File (.ncp) 
Other Setup Types 


Depending on configurations set in the Options Dialog, validation and conflict identification may take place during 
import. The Import Wizard consists of the following panels: 


Welcome Panel 

Import Data Types Panel 

MSI Source Information Panel (for Windows Installer packages) 

MSM Source Information Panel (for Merge Modules) 

Patch Source Information Panel (for Patch Packages) 

OS Snapshot Information Panel (for OS Snapshots) 

Marimba NCP File Information Panel (for Marimba NCP Files) 

Other Setup Installation Files Panel (for Other Setup Types) 

Destination Group Panel (for Windows Installer packages when the Import Wizard is invoked by selecting Import 
File on the Catalog menu, but not when it is invoked from the Group context menu) 
E Summary Panel 


When run, ConflictSolver displays the output report in the Import tab of the Output window. 
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Welcome Panel 


The first panel of the Import Wizard welcomes you to the Wizard. 


Import Wizard 


Welcome to the Import Wizard 


Import Wizard allows you to import a range of different 
installation packages including Windows Installer 
packages (MSI), transforms (MST), patches (MSP), and 
merge modules (MSM) files into the Application Catalog. 


Additionally, you can use the Import Wizard to import pour 
OS snapshots (OSC), Marimba Native Channel packager 
[NCP] and other non-MSI based setup programs. 


Click 'Next' to continue. 


This panel, and others in the Wizard, have four buttons located at the bottom of the Wizard. Depending on where 
you ate in the Wizard, certain buttons may be disabled. The buttons are: 


Button Description 

Next Advances you to the next panel in the Wizard. 

Back Moves you to the previous panel in the Wizard. 

Cancel Terminates the Wizard. 

Help Brings up help specific to the Import Wizard panel currently displayed. 


Click Next to proceed to the Import Data Types Panel. 
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Import Data Types Panel 


Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


From the Import Data Types panel, specify the type of file you are importing into ConflictSolver: 


Import Wizard 


Import Data Types 
Specify the type of data to import. 


There are several different types of data that you can import into the Application Catalog. Select 
the type of data you want to import and press 'Nest' to continue. 


Import Data Types 


MSI Package and Associated Transform Files 


Description 


An MSI package contains all the information Windows Installer needs to install or uninstall an 
application. 4 transform file is used to customize the installation. 


(cise Jue) (tone) (he) 


MSI Package and Associated Transform Files 

MSI Package and Associated Transform and Patch Files 
Merge Module Files 

OS Snapshot File 

Marimba NCP File 

Other Setup Types Files 


Depending on the option selected, clicking Next takes you to one of the following panels: 


MSI Source Information Panel 

MSM Source Information Panel 

OS Snapshot Information Panel 
Marimba NCP File Information Panel 
Other Setup Installation Files Panel 


Click Back to return to the Welcome Panel. 
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From the MSI Source Information panel, you can select the Windows Installer package (.msi) and any associated 
transforms (.mst) that you want to import into ConflictSolver. 


Import Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Select one MSI package file (MSI) in order to proceed with the import process. You may 
optionally select one or more transform files (MST) to be associated with the package file. 


Select an MSI file: 
C:\AdminStudio Shared\Orca.ms 


Transforms [.mst]: 


C:\AdminStudio Shared\Orcal.mst 
C:\AdminStudio Shared\Orca2. mst 


This panel includes the following properties: 


Property Description 


Select an MSI File Click Browse to locate the MSI file you want to import. 


Transforms (.mst) 


area to insert a new Transform file entry line, and then use the Browse button (...) to locate 
the transform. 


If the package requires multiple transforms, you can repeat the procedure as necessary. 
The order in which transforms are applied can be changed by selecting a transform and 


clicking $| (Move Up) and +| (Move Down). If you need to delete a transform you have 
added, select the transform and click x| (Delete). 


Advanced Options Click the Advanced Options button to display the Advanced Options Dialog, from which 
you can configure how to handle custom tables in the package. 


Click Next to proceed to the Destination Group Panel, the Patch Source Information Panel, or the Summary Panel; 
click Back to return to the Import Data Types Panel. 
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From the MSM Source Information panel, you can select the merge modules (.msm) you want to import into 
ConflictSolver. 


Import Wizard 


MSM Source Information 
Specify the MSM file. 


Select one or more merge modules (MSM) files to store in the Application Catalog and click 
‘Next! to continue. 


M rt Modules (msm): 


C:\AdminStudio Shared\pfiles.msm 
C:\AdminStudio Shared\pfileen.msm 


Property Description 


Merge Modules (.msm) 


Browse button (...) to locate the merge module. 


To add multiple merge modules, you can repeat the procedure as necessary. The order of 

the merge modules can be changed by selecting a merge module and clicking $| (Move 
Up) and +| (Move Down). If you need to delete a merge module you have added, select 
the merge module and click x] (Delete). 


Click Next to proceed to the Summary Panel; click Back to return to the Import Data Types Panel. 
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From the Patch Source Information panel, select the patch packages (.msp) you want to import into ConflictSolver. 


Import Wizard 


Patch Source Information 
Specify one or more Patch file(s}. | 


Select one or more Patch files (MSP or EXE) to store in the Application Catalog and click 'Next' 
to continue. 


-Patches [.msp or .exe): 


| 


e ConflictSolver will perform an administrative install of the MSI package and the patch 
files. Then, the MSI package at the installed location, which now contains the patch 
file(s] contents, will be imported into the Application Catalog. 


Specify the location for Administrative insta: 
| C:\AdminStudio Shared\ConflictSolver\Orca 


] 


Property Description 


Patches (.msp) 


If you specify an update.exe patch file that was created by Developer/DevStudio, 
ConflictSolver will extract the .msp file in the Temp folder and then perform the import. 


If the package requires multiple patches, you can repeat the procedure as necessary. The 
order in which patches are applied can be changed by selecting a patch and clicking $| 
(Move Up) and +| (Move Down). If you need to delete a patch you have added, select 
the patch and click x] (Delete). 


Specify the location for For patches to be applied to an MSI package, it is necessary to perform an Administrative 

Administrative install install of the MSI package and then perform an Administrative install of each patch 
package one by one. This way, the content of each patch package is appended to the MSI 
package at the Administrative install location. 


Therefore, click the Browse button and specify a directory to provide ConflictSolver with 
the location where an Administrative Install of selected MSI package will be performed. 


Click Next to proceed to the Destination Group Panel; click Back to return to the MSI Source Information Panel. 
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From this panel, specify or browse to the OS Snapshot file (.osc) you want to import into ConflictSolver. 


Import Wizard 


OS Snapshot Information 
Specify the OS Snapshot file. 


Select an OS snapshot (OSC) file and click Next to continue. 


OS Snapshot: 


C:\AdminStudio Shared\OS Snapshots\windows2000.ose | 


Click Next to proceed to the Summary Panel; click Back to return to the Import Data Types Panel. 
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Import support for Marimba Native Channel Packager (.ncp) files is a snap-in feature available only with InstallShield 
AMS 2.0. 


From this panel, specify or browse to the Marimba NCP File (ncp), named manifest.ncp, that you want to import 
into ConflictSolver. 


Import Wizard 


Marimba NCP File Information 
Specify the Marimba NCP file. 


Select a Marimba's Native Channel Packager (NCP) file and click Next to continue. 


NCOP File: 
[C:MAdminStudio Shared\AcrobatReaderS_Marimba\signed\. nep\manifest.ncp | 


The Marimba NCP file that should be imported into ConflictSolver is always named manifest.ncp. If you attempt to 
import another file with an .NCP extension into ConflictSolver, the import will fail. 


ConflictSolver supports the import of Marimba NCP Version 4.7.2 files. 


Click Next to proceed to the Destination Group Panel; click Back to return to the Import Data Types Panel. 
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Other Setup Installation Files Panel 


This panel appears when you are importing an Other Setup Type setup and have selected Other Setup Types on the 
Import Data Types Panel of the Import Wizard. 


Import Wizard 


Other Setup Installation Files 
Specify the location for the other setup installation files 


Provide a name for the setup and a directory containing the setup files to import and click 'Next' 
to continue. 


Product Name l Marketing Applicatior| 


Directory C:\MyPackages = 


Include entire directory hierarchy 


This panel contains the following properties: 


Name Description 
Product Name Enter a name for this setup. You will be able to rename this setup after it is imported. 
Directory Enter the current location of the setup files that you are importing. 


Include entire directory If you want to import all the files in the specified directory folder and all of its subfolders, 
hierarchy select the this option. If you want to import only the files in the root of the specified 
directory folder, do not select this option. 


Click Next to proceed to the Destination Group Panel; click Back to return to the Import Data Types Panel. 


InstallShield Software Corporation © 2004 947 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


The Destination Group panel allows you to specify the group (or groups) into which you want to import the MSI 
package. 


Import Wizard 


Destination Group 
Specify the destination group for your installer package. 


Select one or more destination groups into which your package will be imported. 


3 CG Groups 
OIG Accounting 
CIG Marketing 
Be 


New... Select All Clear All 
Ca. 


You also have the option of selecting all groups by clicking the Select All button, or deselecting groups by clicking the 
Clear All button. If a group you want to import the package into does not exist, click the New button to create and 
configure it in the Group Properties Dialog. 


Click Back to return to the MSI Source Information; click Next to proceed to the Summary Panel. 


This panel is only displayed when launching the Import Wizard from the Catalog menu. If you rightclick on a group in 
the products explorer and import a package or snapshot, the destination group will be group on which you right- 


clicked. 
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Summary Panel 


Before executing the import, review the information in the Summary panel about the options selected in the previous 
panels. 


Import Wizard 


Summary 
Review your options. 


MSI file to import: 
Orca.msi 


Transform{s): 
Orcal.mst 
Orca2.mst 


Destination group(s) for the package: 
Research 


Options: 
Validate the package before importing? ‘Yes 
Check for conflicts before importing? No 
Import custom tables? Yes 
Import binary data? Yes 


Click Finish to accept these options. 


Depending on the import type and how the Import Wizard was invoked, clicking Back returns you to the Destination 
Group Panel, MSM Soutce Information Panel, OS Snapshot Information Panel, or Other Setup Installation Files 
Panel. Click Finish to begin import. 


Rules Wizard 


The Rules Wizard allows you to create user-defined ACE rules for later use by the ConflictSolver Wizard. It is 
accessible by clicking New on the Rules Viewer Dialog. 


The following panels ate part of the Rules Wizard: 


Welcome Panel 

General Information Panel 
Additional Information Panel 
Custom Options Panel 
Where Clause Panel 
DLL-Based ACEs Panel 
Summary Panel 
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Welcome Panel 


The Rules Wizard allows you to create user-defined ACE rules for later use in conflict identification. The first panel 
displayed is the Welcome panel. 


Rules Wizard 


Welcome to the Rules Wizard 


The Rules Wizard allows you to create and edit 
custom ACE rules for later use by the Conflict 
Wizard. 


Click Next to continue. 


| ae) 


Click Next to proceed to the General Information Panel. 


General Information Panel 


From the General Information panel, you can configure information about the new ACE rule. This information is 
used primarily for display information (Name, Brief Description, Description, and Information URL). 


Rules Wizard 


General Information 
Specify the options common to all ACEs. 


All ACEs require basic information for display and identification. Supply the required data for 
the following properties: 


Name: 


CustomAule2 


Associated T able: 


Brief Description: aie ; 
Å short ACE description displayed when selecting an ACE to execute. 


Description: 
4, description of the ACE displayed during ACE execution. 


Information URL: 


http://www. yourcompany.com 


(cook JC nes J TE Leo] 
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Property Description 


Name The name of the ACE, used to organize the rule in ConflictSolver. This is displayed in 
several places, including the Output window, the Rules Viewer Dialog, and the Conflicts 
tab of the Options Dialog. 


Associated Table Select the table in the Application Catalog which will be queried in the user-defined ACE. 
This also determines which columns are available in the Expression Builder Dialog, and 
which tokens are available for the Error and Display strings on the Custom Options Panel 
of the Rules Wizard. 


Brief Description Enter a brief description which will be displayed in the Rules Viewer, the Conflicts tab of 
the Options Dialog, and in the Output window. This description should be clear enough so 
users can understand when fo use this ACE. 


Description Enter a description of the ACE, which is displayed at the bottom of the Rules Viewer dialog 
when the ACE is selected and in the Output window during conflict identification when the 
ACE executes. 


Information URL Provide a URL to get further information for the ACE. This URL appears in the Conflict 
Details area of the Conflicts View after conflicts have been identified. 


Click Next to proceed to the Additional Information Panel; click Back to return to the Welcome Panel. 


Additional Information 


Prom the Additional Information Panel, you can provide information for categorizing the ACE in relation to other 
ACEs in ConflictSolver. 


Rules Wizard 


Additional Information 
Configure options for categorizing the ACE. 


Additional information is necessary to categorize the ACE during conflict identification. 
Supply the required data for the following properties: 


Category: 


Rule Type: 


| Custom - Source Only Packages 
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Property Description 


Category Either select an existing category for this new rule, or enter the name for a new category. 
These categories are displayed in the Conflict View and the Conflicts tab of the Options 
dialog. Ideally, any user-defined ACEs should be put in their own category. 


Rule Type Specify the type of ACE you are creating: 


= Custom - Source Only Packages ACEs allow you to quickly test any column or 
any value of a table to support your business logic. For example, you could use a user- 
defined ACE to identity packages that create a desktop icon. To define a Source Only 
Packages ACE, you must define a SQL "Where" clause. 


ConflictSolver supports external package conflict checking for Custom - Source Only 
Packages ACEs. The Source package can be selected from the ConflictSolver Application 
Catalog Database or from an external MSI package. 


= Custom - Source and Target Packages ACEs allow you to compare columns or 
values of Source package tables (new packages that you want to install onto a user's 
system) to columns or values of Target package tables (packages already installed on a 
user's system). For example, you could use a Source and Target Packages ACE to 
determine if the installation of a Source package onto a Target system would overwrite 
or conflict with an existing entry in the ini file in the System directory of the Target 
system. To define a Source and Target Packages ACE, you must define a SQL "Where" 
clause, and specify a Join Column—a table column in the Application Catalog 
database that has a matching value for both the Source and Target packages. Rows in 
each of the packages that have a matching value in the Join Column are selected and 
those rows are checked against the Source and Target Packages. 


ConflictSolver does not support external package conflict checking for Custom - Source and 
Target Packages ACEs. Both the Source and Target Packages must be selected from the 
ConflictSolver Application Catalog Database. 


= DLL- User Provided DLL Based ACEs allow you to run more complex tests— 
testing many tables in any combination. For example, you could use a DLL-Based ACE 
to confirm that a source product language is the same as all target product languages. 
To define a DLLBased ACE, you use SQL and various programming languages to 
construct a Windows DLL. With DLL-Based ACEs, you can use a Conflict Application 
Resolution Definition (CARD) to fix the conflict. 


Click Next to proceed to the Custom Options Panel or the DLL-Based ACEs Panel; click Back to return to the 
General Information Panel. 
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Custom Options Panel 
From the Custom Options panel, you can create display strings for the Output Window and Conflict Details. 


Rules Wizard 


Custom Options 
Configure options for categorizing the custom ACE. 


Custom rules have specific display options which need to be specified. Supply the required 
data for the following properties: 


Error String: 


Display String: 


Severity 
© Waming C Report 'No' results 
O Eror 


Cancel Help i 


Property Description 


Error String This string appears in the Output window when a violation of this ACE rule is detected during conflict 
identification. For example, if you were creating a user-defined ACE to identify packages that create 
a desktop icon, you could enter "Failure in creating desktop icon" in this field. 


Tokens allow you to insert values at run-time from the internal ConflictSolver Application Catalog 
Database or an external MSI package into the string, such as specifying a file name. To use token 
replacement in the error string, click on the arrow to the right of the Error String field and pick a value 
from the list, or just type the values directly in the text box, in the following format: 


Source Only Packages ACEs: [Co]umnName] 


Source and Target Packages ACEs: [Source.ColumnName] and [Target.ColumnName] 
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Property Description 


Display String This string appears in the Conflict Details area of the Conflicts View after conflicts have been 
identified. For example, if you were creating a user-defined ACE to identify packages that create a 
desktop icon, you could enter "Duplicate desktop icon found" in this field. 


Tokens allow you to insert values at run-time from the internal ConflictSolver Application Catalog 
Database or an external MSI package into the string, such as specifying a file name. To use token 
replacement in the error string, click on the arrow to the right of the Display String field and pick a value 
from the list, or just type the values directly in the text box, in the following format: 


Source Only Packages ACEs: [ColumnName] 


Source and Target Packages ACEs: [Source.ColumnName] and [Target.ColumnName] 


Severity Specify whether this ACE should be an Error or a Warning. 
Report 'No' User defined ACEs report conflicts based on the provided query. However, you may want fo report 
results the absence of the data if it could not be found. If you select this option, if the ACE does not return 


any results, it will be reported as an error (or warning), with the description and error strings as 
specified. If you expect a 'No' result, do not use tokens in your display or error strings. 


Click Next to proceed to the Where Clause Panel; click Back to return to the Additional Information Panel. 
Token Grammar 
What are Tokens? 


Tokens represent data in the database that is inserted at runtime. In ConflictSolver, Tokens are used to insert values at 
runtime from the ConflictSolver Application Catalog Database or an external MSI package into an Error or Display 
String. 


How to Insert Tokens 


Tokens are specified on the Custom Options panel of the Rules Wizard. To use token replacement in a string, click 
the arrow to the right of the Error String and Display String text boxes and select a column name from the list. The 
column name is then inserted into the string in the following format: 


E Source Only Packages ACEs—[CcolumnName] 


= Source and Target Packages ACEs—[Source.ColumnName] and [Target.CcolumnName], with the prefix 
identifying whether the column is in the Source or Target package. If no prefix is used, ConflictSolver assumes the 
"Source." prefix. 


The Token list on the Custom Options panel is provided for your convenience; if you prefer, you can type the variables 
directly in the text boxes. 
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While you are creating a user-defined ACE in the Rules Wizard, if you initially select a Rule Type of Custom - Source 
and Target Packages, and then insert tokens in the Error String and Display String fields, the "Source." prefix will be 
used. But, before you finish creating this ACE, if you go back and change your Rule Type selection to Custom - Source 
Only Packages, the tokens that you initially entered into the Display and Error string text boxes will not automatically be 
updated fo remove the "Source." prefix. For ConflictSolver to correctly interpret this ACE, you need to manually go 
back to the Error and Display String fields and delete the "Source." prefix. 


Using the ProductName Pseudo-tokens 


You can use the pseudo-tokens of [ProductName], [Source.ProductName] and [Target.ProductName] to insert the 
name of the Source or Target package in an Error or Display String, even though ProductName is not a table column 
name. 


Where Clause Panel 


From the Where Clause Panel, you must define a valid Where clause for the ACE. If you do not know how to build a 
Where clause, you can click the Build Expressions button to launch the Expression Builder Dialog. You can also click 
Test to validate the Where clause syntax. 


Rules Wizard 


Where Clause 
Specify the information required for custom ACEs. 


Custom ACEs require a SOL Where clause to operate. Enter a valid Where clause below, or 
use the Expression Builder to construct one. 


Where Clause: 


Build Expression... 


Join Column 


If you selected Custom - Source and Target Packages on the Additional Information Panel, you must also select a Join 
Column—a table column in the Application Catalog database that has a matching value for both the Source and 
Target packages. Rows in each of the packages that have a matching value in the Join Column are selected and those 
rows are checked against the Source and Target Packages. For example, if you wanted to evaluate Source and Target 
packages that write files to the same directory, you might specify Directory as the Join column. 
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To improve query performance, enclose table names in square brackets ([]). 


Click Next proceed to the Summary Panel; click Back to return to the Custom Options Panel. 


DLL-Based ACEs Panel 


DLL-based ACEs require specific information about the ACE/CARD DLL file and the ACE and CARD Function 
Names to operate. 


Rules Wizard 


DLL-Based ACEs 
Specify the information required for DLL-based ACEs. 


DLL-based ACEs require specific information about the DLL and ACE function name to 
operate. Provide the requested information below. 


ACE/CARD DLL File: 
C:\AdminStudio Shared\MSO.DLL 


ACE Function Name: 
TEST 


CARD Function Name [optional]: 


Enter the following information: 


Property Description 

ACE/CARD DLL File Select the name of the ACE DLL that you are testing. 

ACE Function Name Enter the name that you chose to "export" for this ACE function. 

CARD Function Name Enter the name that you chose to "export" for this CARD function. 

Test Click the Test button next to the ACE Function Name or CARD Function Name to validate 
that the exported function does exist. 


Click Next proceed to the Summary Panel; click Back to return to the Additional Information Panel. 
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Summary Panel 
Once you have configured information for your ACE tule, the Summary panel displays information for final review. 


Rules Wizard 


Summary 
Review selections for this ACE. 


À DLL-based ACE called, 'CustomRule2’, will be created with the following options: 


Category Name: INI Files 

Description: À description of the ACE displayed during ACE execution. 
Brief Description: Å short ACE description displayed when selecting an ACE to e 
Help URL: http: //www.yourcompany.com 

Associated Table: csmsilnstallExecuteS equence 


C:\AdminStudio Shared\MSO.DLL 
TEST 


Click Finish to accept these options. 


| Finish | | Cancel Help | 


Click Finish to accept this configuration and make the ACE available for conflict identification. Click Back to return 
to either the Where Clause Panel or the DLL-Based ACEs Panel 


Remote Package Alert Wizard 


ConflictSolver's Remote Package Alert feature allows you to copy packages between various Application Catalogs and 
maintain consistency between the copied packages. This allows you to maintain multiple Application Catalogs that 
match your corporate organization and optimize the performance of AdminStudio. 


The Remote Package Alert Wizard consists of the following panels: 


Welcome Panel 

Remote Link Application Catalog Panel 
Groups Panel 

Summary Panel 


When run, ConflictSolver displays the output report in the Remote Package Alert tab of the Output window. 


When you link to a remote package, ConflictSolver connects to the linked remote application catalog and imports an 
MSI package into the local application catalog. In order for Remote Package Alert to work properly, both the remote 
application catalog and the remote MSI file must be accessible to the linked users at all times. In other words, both the 
remote application catalog and all of the MSI files that have been imported into it must be able to be accessed by 
linked users via a shared network drive. 
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Welcome Panel 


The first panel of the Remote Package Alert Wizard welcomes you to the Wizard. 


Remote Package Alert Wizard 


Welcome to the Remote Package Alert 
Wizard 


This wizard will guide you through the process of 
creating a new link to a remote application catalog. 


Click Next to continue. 


erm [reo] 


This panel, and others in the Wizard, have four buttons located at the bottom of the Wizard. Depending on where 
you ate in the Wizard, certain buttons may be disabled. The buttons are: 


Button Description 

Next Advances you to the next panel in the Wizard. 

Back Moves you to the previous panel in the Wizard. 

Cancel Terminates the Wizard. 

Help Brings up help about the specific Remote Package Alert Wizard panel. 
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Remote Link Application Catalog Panel 


On the Remote Link Application Catalog panel of the Remote Package Alert Wizard, you select the Access/SQL 
Server Application Catalog that you want to link to. 


Remote Package Alert Wizard 
Remote Link Application Catalog 
Specify the Application Catalog to remotely link 


Specify the application catalog that is to be linked remotely. Click Next to continue. 


Remote Application Catalog Type: 


if 
| Microsoft Access 


Remote Application Catalog: 
[C:\AdminStudio Shared\HoweT echnology.mdb 


(cise J ne] (oxen) (Hop) 


During the linking process of an SQL Server Application Catalog, ConflictSolver will save the name of the database 
server, authentication mode, and name of the Application Catalog. 


When you open ConflictSolver, by default ConflictSolver will attempt to connect to your SQL Server Application 
Catalog using NT authentication mode. If that fails, ConflictSolver will display the SQL Server / MSDE Login Dialog 
and prompt you for a Server, Login ID, Password, and Database. 


If you use SQL Server Authentication Mode to login to your SQL Server Application Catalog, ConflictSolver will not save 
SQL login information. Therefore, each time you want to refresh the data from this remote application catalog, you will 
have to supply ConflictSolver with the login information. Therefore, it is recommended that you use NT authentication 
mode to login to SQL Server Application Catalogs. 


Field Description 


Remote Application Select the type of database of the application catalog you want fo link to. 
Catalog Type 


Remote Application Specify the name and path of the application catalog. 
Catalog 
Change Click to browse to the location of the application catalog. 
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Groups Panel 


On the Groups panel of the Remote Package Alert Wizard, you link to different packages within an Application 
Catalog. Specify the package within an application catalog that you want to link to by selecting the checkbox next to 
the package name. 


Remote Package Alert Wizard 


Groups 
Specify the application catalog data to be remotely linked 


Specify the application data to be remotely linked. Click Next to continue. 


SROI] Groups 

(CA) ACEOBConflict ¥1.00.0000 

cH) ACETests 

JG Adobe 
CE DemoPlayer v1.00.0000 
O InstallShield AdminStudio v5.01 
OG McAfee VirusScan v4.5.0 
oe Narteo_ACEO6 Two v1.00.0000 
O OmniPage Pro 10.0 v10.0.0.0 
PackageForTheWeb 4 v4.0.0 
OG PackageForTheWweb 4 v4.0.0 

Tia Patch M4 


ETE mE (cones) (rep) 


Summary Panel 


The Summary panel provides a detailed summary of the options that were selected in the previous panels of the 
Wizard. Click Finish to complete the remote link. Clicking Back returns you to the Groups panel. 


Remote Package Alert Wizard 


Summary 
Review your remote package alert options. 


Remote Server 
C:\AdminStudio Shared\HoweT echnology.mdb 


Remote Packages 


Groups 
PackageForTheWeb 4 


ETE mE 
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Merge Wizard 


The Merge Wizard, available by clicking Merge on the Catalog menu, allows you to merge application data between 
two Application Catalogs. The source Application Catalog's data is merged into the currently open Application 
Catalog. 


The following panels are included in the Merge Wizard: 


Welcome Panel 

Source Application Catalog Panel 
Groups Panel 

Progress Panel 


Welcome Panel 


The first panel in the Merge Wizard is the Welcome panel. Click Next to proceed to the Source Application Catalog 
Panel. 


Merge Wizard 


Welcome to the Merge Wizard. 


This wizard will guide you through the process of 
merging application data from another Application 
Catalog. 


Click Next to continue. 
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Source Application Catalog Panel 


From the Source Application Catalog panel, you can specify type of Application Catalog to use as the source for the 
merge: Microsoft Access—based or SQL Server / MSDE-based. Once you have specified the type, click Change to 
either browse to the Access—based Application Catalog, or use the SQL Server / MSDE Login dialog to provide 
information for a SQL Server—based Application Catalog. 


Merge Wizard 
Source Application Catalog 


Specify the source Application Catalog to merge. 


Specify the source application catalog that contains the data to be merged. Click Next to 
continue. 


Source Application Catalog Type: 


Microsoft Access 


Source Application Catalog: 
C:\AdminStudio Shared\HoweApplicationCatalog. mdb 


Application Catalog version '5.5' 


Click Next to proceed to the Groups Panel; click Back to return to the Welcome Panel. 


Groups Panel 


From the Groups panel, you can select the groups you want to merge. The available groups displayed are from the 
source Application Catalog, and data from the selected groups will be merged into the current Application Catalog. If 
you select the option to Replace duplicate application data, if a duplicate package exists in the current Application 
Catalog, the source Application Catalog's package will overwrite the duplicate. 


Merge Wizard 


Groups 
Select the application data to merge 


Specify the application data to be merged. Click Next to continue. 


SEDI] Groups 
O ACEO6Conflict v1.00.0000 
a- ACETests 


a- Adobe 
DemoPlayer v1.00.0000 
InstallShield AdminStudio v5.01 
McAfee VirusScan v4.5.0 
Nartco_ACE06 Two v1.00.0000 
OmniPage Pro 10.0 ¥10.0.0.0 
PackageForTheWeb 4 v4.0.0 
TVS PackaaeF orTheWeb 4 v4.0.0 _ 


Replace duplicate application data 


Cra Juma) (exes) (“Hoe 
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Click Next to proceed to the Progress Panel and begin the merge; click Back to return to the Source Application 
Catalog Panel. 


The Progress panel displays messages from the merge process. 


Merge Wizard 


Progress 
Merging 


Merge progress: 


Friday, January 09, 2004 04:17:33PM 
Merge process started: 


Source Application Catalog : 'HoweT echnology.mdb' 
Destination Application Catalog: 'testlabsql2k [HowePublisher2004) - sa’ 


C:\AdminStudio Shared\PackageForl heWeb 4. msi 

Import started at: Friday, January 09, 2004 - 4:17 PM ... 

Source package: C:\AdminStudio Shared\PackageForl heWeb 4.msi 
Importing table ‘ActionT ext’... 


v 


2 


Cea e 


When the merge is complete, review the log as necessary and click Finish to exit the Wizard. 


Validation Wizard 


The Validation Wizard allows you to validate a Windows Installer package and any associated transforms prior to 
importing them into ConflictSolver. Validation is performed against the validation file (.cub) selected in the Validate 
tab of the Options dialog (available from the Tools menu). 


The following panels are included in the Validation Wizard: 


m MSI Source Information 
E Summary 
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From the MSI Source Information Panel, specify the Windows Installer package you want to check for conflicts 
against packages already in ConflictSolver. 


Validation Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Specify a Windows Installer package (.msi) and any associated transforms (.mst). Click Next 
to continue, 


Select an MSI file: 


C:\AdminStudio Shared\Orca.msi 
[Transforms (.mst): pal [x l t | + | 


‘AdminStudio Shared\Orcal mst 


Transforms area. Use the Browse button (...) to locate the transform. If the package requires multiple transforms, you 
can repeat the procedure as necessary. The order in which transforms are applied can be changed by selecting a 


transform and clicking $| (Move Up) and +| (Move Down)..You can delete a transform from the Transform files 
list by selecting the transform and clicking x! (Delete). 


Click Next to proceed to the Summary Panel. 
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Summary Panel 


From the Summary panel, you can review the Windows Installer package and any associated transforms you will 
validate against the specified CUB file. 


Validation Wizard 


Summary 
Review your options, 


MSI/MST file name to validate: 
C:\AdminStudio Shared\Orca.msi 


List of transforms to validate. 
C:\AdminStudio Shared\Orcal.mst 


Click Finish to accept these options. 


C CR) Ceo) (ee) 


If the options are correct, click Finish to begin validation. If not, click Back to return to the MSI Source Information 
Panel. 
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Taking OS Snapshots 


OS Snapshot Wizard is included with AdminStudio Professional Edition. 


The OS Snapshot Wizard provides a simple way to capture your basic operating system configuration. Using the OS 
Snapshot Wizard, you can scan your computer's operating system and record the files, INI files, shortcuts, and registry 
entries present. The Wizard then creates an .osc file representing the system contents. You can import this snapshot 
file into the ConflictSolver database to identify potential conflicts between Windows Installer-based setups and your 
operating system. 


To provide maximum flexibility during the OS Snapshot process, you can create an exclusion list (similar to the 
Repackager exclusion list) that identifies files, INI files, shortcuts, and registry entries that the OS Snapshot Wizard 
should disregard during the scan. Using this list, you can eliminate unnecessary files, shortcuts, or registry entries, and 
reduce the time it takes to perform the OS Snapshot. 


OS Snapshots should only be used for comparison in ConflictSolver. You should never attempt to convert an OS 
Snapshot into an MSI package. 


Before capturing OS Snapshots, consider the following: 


Guideline Description 
Capture on a Clean For optimal OS Snapshots, you should only capture on a clean system. This ensures an 
System accurate baseline of files necessary for the operating system. This also means that you 


should never attempt to capture other packages in addition to the operating system. Use 
Repackager when you need to capture applications. 


Exit Other Applications Shut down all other applications besides OS Snapshot prior to capture. Ideally, this should 
be done from the Windows Task Manager. This ensures that files are not locked during 
capture, and unnecessary temporary files are not inadvertently captured. 


Only Use OS Snapshot Never attempt to convert an OS Snapshot file into a Windows Installer package to install 


for Import into an operating system. AdminStudio does not support this use of OS Snapshots. 
ConflictSolver 

OS Snapshots Take Depending on the operating system configuration, OS Snapshot often takes a significant 
Time amount of time to capture the base OS state. Consider that many typical OS installations 


exceed 500MB and contain tens of thousands of files, translating into a lengthy operation 
of cataloging and converting the files into an OS Snapshot file. 
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Guideline Description 
Take Multiple OS If your environment contains either multiple operating systems, or variations on the same 
Snapshots operating system, take snapshots of each OS or variation. You can store all of these in 


ConflictSolver, allowing you to make comparisons between MSI packages and each OS. 


OS Snapshots and OS Snapshots, as the name implies, is for snapshots of the operating system only. 
Repackaging Are Not Repackaging is only for traditional installation packages. These operations, although 
the Same similar, are still very specialized and should only be used for their respective purposes. 


Configuring OS Snapshot Analysis Options 


ime 

Bi 

To configure analysis options for OS snapshot captures: 

1. Launch the OS Snapshot Wizard by clicking on its icon in the AdminStudio Tools Gallery. The 


Welcome Panel opens. 


InstallShield OS Snapshot Wizard 


Welcome to InstallShield OS Snapshot Wizard 


This wizard enables you to create a snapshot of your 
current operating system configuration. It is highly 
recommended that you use a clean system when 
capturing an OS Snapshot. 
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2. From the Welcome Panel, click Next. The Project Information Panel opens. 


InstallShield OS Snapshot Wizard 


Project Information 
Provide OS Snapshot project information, 


Provide the project name for the osc file and the project folder to store the OS Snapshot 
and other related files. 


OS Snapshot project name: 


WindowsXP 


OS Snapshot project Folder: 
C:\05 Snapshots ® 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis. 


3. From the Project Information Panel, click Edit. The Analysis Options Dialog opens. 


Analysis Options 


Capture types 
S Shortcuts 
Deleted files Registry data 
INI files Deleted registry data 


Non-.ini extensions 


Restrict directory analysis to the following: 


ch 


Edit Delete 


4. From the Analysis Options Dialog, configure the types of data you want to capture (Files, INI files, 
Shortcuts, and/or Registry data), and specify if you want to restrict the snapshot to a specific drive. 


5. Click OK to return to the Project Information Panel. 


6. Click Start. 
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Performing OS Snapshots 


To perform an OS Snapshot: 
1. Launch the OS Snapshot Wizard by clicking on its icon in the AdminStudio Tools Gallery. The 


Welcome Panel opens. 


InstallShield OS Snapshot Wizard 


Welcome to InstallShield OS Snapshot Wizard 


This wizard enables you to create a snapshot of your 
current operating system configuration, It is highly 
recommended that you use a clean system when 
capturing an OS Snapshot, 


InstallShield OS Snapshot Wizard 


Project Information 
Provide OS Snapshot project information, 


Provide the project name for the .osc File and the project folder to store the OS Snapshot 
and other related files. 


OS Snapshot project name: 


WindowsXP 


OS Snapshot project Folder: 
C:\05 Snapshots 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis. 


InstallShield Software Corporation © 2004 969 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


3. On the Project Information Panel, provide the OS Snapshot project name and OS Snapshot project 
folder for the OS Snapshot file. 


4. Optionally, click Edit to configure analysis options. 
5. Click Start to perform the OS Snapshot. 


6. On completion of the OS Snapshot, review the results in the Summary Panel. 


InstallShield OS Snapshot Wizard 


OS Snapshot Summary 
Please ready the summary information below carefully and click Finish to exit, 


Summary Information: 
The OS Snapshot has been created: 


OS Name: WindowsxP 


Snapshot: C:\05 Snapshots2\WindowsxP.osc 


The OS Snapshot {.osc) file can be imported into ConflictSolver by selecting Import File from 
the Catalog menu. 


7. Click Finish. 


The OS Snapshot is stored as an OSC file in the folder defined in the Project Information Panel. 
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OS Snapshot Reference 


The following topics contain information about each Wizard panel and dialog box available through the OS Snapshot 
Wizard. The help topics in this reference are the same detailed documentation that is displayed when you press the F1 
key or click the Help button while working in a Wizard or dialog. 


Welcome Panel 


The Welcome panel appears when you first launch the OS Snapshot Wizard, providing some introductory 
information about the use of the OS Snapshot Wizard. 


InstallShield OS Snapshot Wizard 


Welcome to InstallShield OS Snapshot Wizard 


This wizard enables you to create a snapshot of your 
current operating system configuration, It is highly 
recommended that you use a clean system when 
capturing an OS Snapshot, 


The Next button advances you to the Project Information Panel. 
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Project Information Panel 
The Project Information panel gathers information necessary for taking the OS Snapshot. 


InstallShield OS Snapshot Wizard 


Project Information 
Provide OS Snapshot project information, 


Provide the project name for the „osc file and the project folder to store the OS Snapshot 
and other related files, 


OS Snapshot project name: 


WindowsXP 


OS Snapshot project Folder: 
C:\O5 Snapshots | Lis) 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis. 


You must provide the following information before the Start button is enabled, allowing you to take the snapshot. 


Field Description 

OS Snapshot project Provide a name for the snapshot file (.osc). 

name 

OS Snapshot project Provide the directory in which snapshot data will be stored. Either enter the path in the 

folder field, or click the Browse (...) button to navigate to it. If the directory already exists, a 
confirmation dialog appears when you click the Next button. 


If you want to review or change current capture settings, click Edit to display the Analysis Options Dialog. 
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Analyzing Panel 


The Analyzing panel appears while the OS Snapshot Wizard analyzes your system. 


InstallShield OS Snapshot 


Performing OS Snapshot... 
Please wait while InstallShield OS Snapshot Wizard performs system analysis. 


The system is performing the OS Snapshot... 


Reading link data... 


CHA WHistory 


Following the snapshot, the Summary Panel appears. 


OS Snapshot Summary Panel 


At the end of the OS Snapshot process, the Summary panel is displayed, containing information about the OS 
Snapshot that was just performed. 


InstallShield OS Snapshot Wizard 


OS Snapshot Summary 
Please ready the summary information below carefully and click Finish to exit, 


Summary Information: 
The OS Snapshot has been created: 


OS Name: WindowsXP 


Snapshot: C:\05 Snapshots2\\WindowsxP.osc 


The OS Snapshot {.osc) file can be imported into ConflictSolver by selecting Import File From 
the Catalog menu. 


Prior to clicking Finish, review the information to ensure the snapshot contains the data you expected. 
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Following the OS Snapshot process, you can import the snapshot into ConflictSolver and use it as a baseline to which 
setups can be compared. 


OS Snapshots should only be used for comparison in ConflictSolver. You should never attempt to convert an OS 
Snapshot into an MSI package. 


Analysis Options Dialog 


The Analysis Options dialog, accessible by clicking Edit from the Project Information Panel, allows you to specify 
capture types for the OS snapshots. 


Analysis Options 


Capture types 
Shortcuts 
Deleted files Registry data 
INI files Deleted registry data 


Non-.ini extensions 


Restrict directory analysis to the following: 


Cs 


You can select the following: 


Files 

INI files 
Shortcuts 
Registry data 


Additionally, you can restrict directory analysis to specific directories, which can significantly improve OS Snapshot 
Wizard performance. Click New to add a directory restriction, edit to modify an existing restriction, or delete to 
remove a restriction. 


Options set in this dialog apply to the current and subsequent snapshot sessions. 


InstallShield Software Corporation © 2004 974 


AdminStudio 5.5 User Guide 12 Identifying and Resolving Application Conflicts 


The ISSnapshot.ini file is the default exclusion file for the OS Snapshot Wizard. It contains exclusions to be applied 
when capturing an OS snapshot, and mainly focuses on specific items that should not be included in applications, 
such as InstallShield Professional-specific COM settings and OS Snapshot-specific registry entries. 


The file is located in the Windows folder, and can be edited using the Global Exclusions Editor, or using a text editor. 


w 


InstallShield strongly recommends you not modify this file, as it increases the likelihood of either inadvertently omitting 
necessary pieces of the OS snapshot, or including registry entries or files that should not be part of the snapshot. 
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Preparing Packages for 
Distribution 
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Deploying an MSI Using an InstallShield Script-Based Setup.exe..........ccccccccccccee 1012 


Distribution Wizard te PEPE PPE EEE ECE PCE EP CECE PEPE CECT ELEC PCCP CEES TPCT ECPTEP ECT TET CEES 1 01 3 


Welcome Paine ls cisvcscassectsccctscsceststvcsscsscscesssssdesssvessccessscestuecssssescucesesessessesesssscscedesdessosssssossesceseossesees 0S 
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Distribution Type Panel .............cccccccccccccccccccccccccccccccccccccccccccccccccccccsccceccccccccccscccccccscccccccccsscccccssssees LOWS 


Marimba: Integration: Panel saiisine a AE EE aaa EE aAa TT 1019 
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The final step in the application migration process is preparing your packages for distribution. AdminStudio includes 
the Distribution Wizard to assist you in deploying your package (and any associated transforms) to a network location, 
an PTP server, as an administrative installation, using Marimba channel publishing technology, via a Tivoli or SMS 
software package definition file, via LANDesk distribution, or via Altiris distribution. This section also explains how 
to deploy an MSI using an InstallShield script-based setup.exe. 


Distributing Packages to Network 
Locations 


To distribute your package (and any associated transforms) to a network location: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk. 


Click Next to proceed. 


Ere mrm 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 


i 9] Cee) 


Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Distribution Type: 


A ~ 


Description 


Distribute into a network directory. 
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6. From the Distribution Type Panel, select Network Location and click Next. The Network Location Panel 
opens. 


InstallShield Distribution Wizard 
Network Location 


Specify the network location to distribute the installation package 


Then installation will be copied to the network directory that you specify. Click Browse to 
choose the network location. 


Network Directory: 


| germa 


mre mre 


7. From the Network Location Panel, specify or browse to the Network Directory location to which you 
want to distribute the package, and click Next. The Distribution Summary Panel opens. 


InstallShield Distribution Wizard 


Distribution Summary 
Displays the summary for the current distribution options. 


You have selected to distribute to a network location. 


The Following Windows Installer package file will be distributed: 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The file will be copied to the 'C:\AdminStudio Shared’ network drive. 
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8. On the Distribution Summary Panel, review the selections you made. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files. The Distribution Output Panel 
displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution Finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\Adminstu 


Bad [ He ]. 


9. Once the distribution finishes, click Finish to exit the Distribution Wizard. 
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Distributing Packages to FTP Servers 


To distribute your package (and any associated transforms) to an FTP server: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel appears. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk. 


Click Next to proceed, 


Ere mre 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
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Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Distribution Type: 


FTP Location v | 


Description 


Distribute to an FTP server, providing both your username and password. 
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6. From the Distribution Type Panel, select FTP Location and click Next. The FTP Location Panel opens. 


InstallShield Distribution Wizard 


FTP Location 
Specify the FTP location to distribute the installation package 


You can upload this information to an FTP server, 


FTP Location: 


Examples: ftp://servername/dir or servername/dir 


User Name: 


Password: 


User name and password are case-sensitive, 


7. From the FTP Location Panel, specify the location of the FTP server, and the user name and password to 
use to connect to the server. Click Next. 


The Distribution Summary panel appears: 


InstallShield Distribution Wizard 


Distribution Summary 
Displays the summary for the current distribution options. 


You have selected to distribute to a FTP server. 


The Following Windows Installer package file will be distributed: 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The File will be copied onto the FTP server, ‘ftp://networkserver/dir', using ‘admin’ as your 
user name and ‘administrator’ as your password, 


8. Review the selections you made in the Distribution Summary panel. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files. 


9. The Distribution Output panel displays progress during distribution. Once the distribution finishes, click 
Finish to exit the Distribution Wizard. 
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Creating Administrative Installations for 
Packages 


To distribute your package (and any associated transforms) as an administrative 
installation: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk, 


Click Next to proceed, 


er mrm 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
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Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Description 


The installation is copied to a network directory using the administrative install option 
provided by Windows Installer, 
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6. From the Distribution Type Panel, select Administrative Install and click Next. The Administrative Install 
Panel opens. 


InstallShield Distribution Wizard 


Administrative Install 
Specify the network location to distribute the installation package 


The installation will be copied to the network directory using the Administrative install option 
provided by Windows Installer. Choose the directory and click Next to proceed, 


Network Directory: 


Browse... 


Cluse short file names 


mre mre 


7. From the Administrative Install Panel, specify or browse to the Network Directory to which you want to 
distribute the package. 


8. If desired, you can use short file names during the distribution by selecting the Use short file names 
option. 


9. Click Next. The Distribution Summary Panel opens. 


InstallShield Distribution Wizard 


Distribution Summary 
Displays the summary for the current distribution options. 


You have selected to distribute to a network location using the Administrative install option 
provided by the Windows Installer. 


The Following Windows Installer package file will be distributed: 
C:\\AdminStudio Shared\PackageForTheWeb 4.msi 


The file will be copied to the 'Y:\' network drive using the Windows Installer Administrative 
install option. 
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10. On the Distribution Summary Panel, review the selections you made. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files. The Distribution Output Panel 
displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution Finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\Adminstu 


Bad [ He ]. 


11. Once the distribution finishes, click Finish to exit the Distribution Wizard. 
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Using Marimba Channel Publishing for 
Package Deployment 


Systems Administrators use the Marimba Desktop suite of products to ensure that users in their network always have 
the most recent software on their local computer. Distribution Wizard makes it easy for you to efficiently distribute 
packages using Marimba. 


In Marimba Channel Publishing, the System Administrator publishes an application (called a Channel) on a Marimba 
Transmitter web site. The Marimba Desktop Tuner component, installed on a user's local machine, communicates 
with the Transmitter web site to find out which Channels this user has subscribed to, and if any of those Channels 
have recently been updated. 


Initially, the Marimba Desktop Tuner downloads the Channels that the user has subscribed to, installs them on the 
user's local machine. Then it periodically checks the Transmitter web site to see if any of this user's subscribed 
Channels have been updated. You can use the Distribution Wizard to create and publish a Channel (such as an 
installation setup) on the Transmitter web site so that the Marimba Transmitter can download a Channel to a local 
machine. 


Hete is a review of terms associated with Marimba distribution: 


Term Description 

Marimba Desktop An application on your local computer that downloads Channels from the Transmitter, 
Tuner allowing you to run the Channel applications on your local computer. 

Transmitter The application that stores the original Channel before it is downloaded to your computer. 


It usually runs on another computer in your network. 


Channel Any application or file that the Marimba Desktop Tuner downloads to your computer. 
Channels are initially stored on the Transmitter and then the Marimba Desktop Tuner 
downloads the Channels so you can run them on your local computer. 


Subscription The process of getting a Channel on your computer. Once you subscribe to a Channel, the 
Marimba Desktop Tuner keeps track of it, making sure the information is up to date. The 
Marimba Desktop Tuner and the Channel are automatically set up to make sure the 
Channel stays up to date on the local computer by downloading updates at scheduled 
intervals. 
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To distribute your package (and any associated transforms) using Marimba Channel 
publishing: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk. 


Click Next to proceed. 


InstallShield Distribution Wizard 


Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 


Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
T xe 3 Seine 


L 


Additional Transforms 
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3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 
Distribution Type 


Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Distribution Type: 
Perwa OOOO ë | 


Description 


4 new Marimba channel is created and files are copied to it for distribution. 


InstallShield Distribution Wizard 


Marimba Integration 


A « 
Specify the channel creation and publishing parameters marimba 


Specify the type of distribution you want to perform From the given list and click Next to 
proceed, 


Channel Creation 
Specify the directory where you want to place the contents of the new channel: 


| v Browse... 


Include all the files that are in the same directory as the Windows Installer package 


Channel Publishing (Optional) 
Specify the destination channel URL on the transmitter: 


L _ 
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7. On the Marimba Integration Panel, do the following: 


a. Specify the directory where you want to place the contents of the new Channel— 
Specify the directory where you want to place the MSI file, or click Browse to select it. This 
directory will be called the Channel Directory. 


b. Include all the files that are in the same directory as the Windows Installer 
package-—If desired, select this option. If this option is selected, all the files and folders in the 
same directory as the MSI package will be copied into the Channel Directory. 


c. Specify the destination Channel URL on the transmitter —This is an optional field. This is 
the URL to the Transmitter that contains the Channel. For example, the URL to a Transmitter might be 
htto://trans.marimba.com. The URL to a Channel on that Transmitter might be 
http: //trans.marimba.com/MyChannel. However, if you specify a value in this field, you must also 
specify the Channel Copier URL field on the Advanced Marimba Options Dialog. 


Using Distribution Wizard, users can specify where they would like to copy an MSI package and all the other 
related files. The Distribution Wizard will then automatically find the Application Packager Channel URL and 
copy the files at the specified location. This location is called the Channel Directory. Users have a provision to 
specify any other Application Packager URL. The Channel Directory is also referred to as the Publish Directory. 
Distribution Wizard is required to be able to find the Application Packager Channel URL. 


8. To specify advanced Marimba options for Channel Creation and Channel Publishing, click Advanced 
to access the Advanced Marimba Options Dialog. 


® Advanced Marimba Options 


Specify advanced Marimba options for Channel Creation and Channel Publishing. 


Default Channel Creation Settings 
Specify the Application Package URL 


Specify the XML template file: 


C:MnstallShield AdminStudio\Current\Support\MarimbaMSIpackage {i 


Default Channel Publishing Settings (Optional) 
Specify the channel copier URL 


TestChannelCopierJAL1234 l © 


a. Specify the Application Package URL—The Application Package URL will be used to copy 
the files to the Channel directory. Accept the default application package URL or enter a new one. 


b. Specify the XML template file—The XML template file sets properties for the MSI file during 
Marimba distribution. Accept the default XML template file that was shipped with AdminStudio, or 
enter a new one. 
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c. Specify the Channel Copier URL—If you have specified a destination Channel URL on the 
transmitter, then specify the URL for the Channel Copier. Distribution Wizard uses the Channel 
Copier URL to publish the channel to a transmitter, where it will be available to desktops. 


d. Click OK to return to the Marimba Integration Panel. 


9. On the Marimba Integration Panel, click Next. The Distribution Summary Panel opens. 


InstallShield Distribution Wizard 


Distribution Summary 


7 « 
Displays the summary for the current distribution options. marimba 


You have selected to distribute to a Marimba server. 


The Following Windows Installer package file will be distributed: 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The file will be copied to the 'C:\AdminStudio Shared’ Marimba channel. 
Using the XML template file 'C:\Program Files\InstallShield\AdminStudio\S.O\Support 
\MarimbaMSIpackage.xml' 


Ccm J (“Hap 


10. Review the selections you made in the Distribution Summary Panel. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files. The Distribution Output Panel 
displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 


Copying files from 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared' 
Copying 'C:\AdminStudio Shared\ACROBATREADER MSI’ --> 'C:\AdminStu 


11. Once the distribution finishes, click Close to exit the Distribution Wizard. 
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Preparing for Tivoli Distribution 


To prepare your package for Tivoli distribution: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk, 


Click Next to proceed, 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
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Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 
Distribution Type: 


[voi 


Description 


Creates a Tivoli software package definition file (SPD) and copies the files to a network 
location, 


Cra Jone) (tan) (He) 
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6. From the Distribution Type Panel, select Tivoli and click Next. The Tivoli Integration Panel appears. 


InstallShield Distribution Wizard 


Tivoli Integration " p 
Specify the network location to store the installation package. Tivoli. softwa re 


The product information is imported from the MSI file, 
Product Name: PackageForTheweb 4 
Product ¥ersion: 4.0.0 


Manufacturer: InstallShield Software Corporation 


The installation and the Tivoli SPD file will be copied to the network directory that you specify. 
Click Browse to choose the network location, 


Network Directory: 


Bee] 


7. From the Tivoli Integration Panel, specify or browse to the Network Directory where you want to store 
the installation package and created SPD file. Click Next. The Tivoli Settings Panel opens. 


InstallShield Distribution Wizard 
Tivoli Settings z z 
Optionally change the install action of a feature. Tivoli. softwa re 


Specify the directory from which you want to launch the product installation. 
Target Image Path C:\AdminStudio Shared | 


Do not redirect installation to a remote system 


Enter a Source Image Path to bundle the images in the software packages. 


Source Image Path  [C:SAdminStudio Shared | 


C] Keep Images 


C] Available to All Users Compression 
© Deflated 


O Stored 
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8. From the Tivoli Settings Panel, configure settings as necessary and click Next. The SPD Parameters 
Panel opens. 


InstallShield Distribution Wizard 


SPD Parameters Panel. ast: 
Select parameters for the Software Package Definition File. Tivoli. softwa re 


Select the feature and click its button to change the install action for it. 


Description 


PackageForTheweb4NewFeature PackageForTheweb4NewFeature 


NewFeaturel 


[cise Jone) (tan) (te) 


9. From the SPD Parameters Panel, configure each feature's install state. When finished, click Next. The 
Distribution Summary Panel opens. 


InstallShield Distribution Wizard 


Distribution Summary 


Displays the summary for the current distribution options. Tivoli. softwa re 


You have selected to distribute to a Tivoli Package. 


The following Windows Installer package file will be distributed: 


C:\AdminStudio Shared\ InstallShield Deyveloper.msi 


The file will be copied to the ‘C:\\" network drive. 


The following software package definition file will be created: 
C:\InstallShield Developer.spd 
v 


2 
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10. On the Distribution Summary Panel, review the selections you made. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files, to the location specified in the 
Tivoli Integration Panel. The Distribution Output Panel displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. O> 


Distribution finished at 11-Jul-2003, 15:28:08 PM 
PEUTIC EEE) 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying Files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\AdminStu 


11. Once the distribution finishes, click Finish to exit the Distribution Wizard. 


Any associated transforms are merged into the Windows Installer package before the package is distributed to Tivoli. 
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Preparing for Altiris Distribution 


The Distribution Wizard supports the distribution of a setup along with any transforms and files via an Altiris 
Notification Server. A custom script file is required for Altiris distribution. The Distribution Wizard creates this 
custom script file using an XML template file that is provided: AltirisTemplate.Config. 


To prepare your package for Altiris distribution: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk, 


Click Next to proceed, 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
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Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative 
Installation, Marimba, Tivoli, SMS, LANDesk or Altiris. 


Specify the type of distribution you want to perform From the given list and click Next to 
proceed, 


Distribution Type: 
Altiris 


Description 


Create a package in Altiris Notification Server. 
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6. Select Altiris from the Distribution Type list and click Next. The Altiris Integration Panel opens. 


7. 


InstallShield Distribution Wizard 


Altiris Integration Ea S 
Specify the parameters for Altiris Distribution . y a Iti ns 


Specify locations for created files, You also have the option of specifying additional Windows 
Installer command line options, 


Network Directory: 


C v| (Browse... J 


Windows Installer Command Line: 


msiexec fi "InstallShield Developer .msi" 


Notification Server Connection 
Altiris Server Location: (Examples: http://servername or http://server ip address) 


User Name: Password: 


In the Network Directory field, specify or browse to the network location where you want to store the 
installation package. The Distribution Wizard remembers the last Network Location that is entered and 
displays it the next time this Panel is accessed. 


The Distribution Wizard will copy the Windows Installer package along with any transforms and files to 
the UNC path specified. Also, the Distribution Wizard will use an XML template file 
(Altiristemplate.config) to create a custom script file in this location named <packageName>.Config. 


You can edit Altiristemplate.config to customize it for your organization. The file, which is installed with 
AdminStudio, is located in the Templates folder of the AdminStudio Shared Directory. See Altiris XML Template 
for more information. 


In the Windows Installer Command Line field, enter any additional properties that you want to pass to 
the Windows Installer. See the Windows Installer Property Reference for more information. 


In the Altiris Server Location field, enter the http: address for the location of the Altiris Server. The 
Distribution Wizard remembers the last Altiris Server Location that is entered and displays it the next 
time this Panel is accessed. 


10. In the User Name and Password fields, enter a User Name and Password to log onto the server entered 


in the Altiris Server Location field. The Distribution Wizard remembers the last User Name that is 
entered and displays it the next time this Panel is accessed. 


11. Click Next. The Distribution Summary Panel appears, listing the selections you made in the previous 


panels. 
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12. Review the information on the Distribution Summary Panel. If you are satisfied with them, click Next. 
The Distribution Output Panel displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution Finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying Files From 'C:\AdminStudio Shared! --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\AdminStu 


13. Once the distribution finishes, click Finish to exit the Distribution Wizard. 


For all distribution types, the Distribution Wizard will create a Distribution log file in the Distribution folder of the 
AdminStudio Shared Directory. 
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Preparing for SMS Distribution 


For detailed information on SMS template files and the variables they use, see SMS File Templates. 


To prepare your package for SMS distribution: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk, 


Click Next to proceed, 


mre mre 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 
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Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Description 
Create a package definition file for distribution via SMS. 


(cise Jone) (tones) (He) 
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6. From the Distribution Type panel, select SMS and click Next. The SMS Distribution Panel opens. 


InstallShield Distribution Wizard 


SMS Distribution 
Configure the parameters for SMS. 


4 package definition file is a text file that contains all the information necessary to create a software 
distribution package for an application. SMS 1.2 or earlier uses PDF file extension. SMS 2.0 or later 
uses SMS file extension. 


C Create Package Definition File (SMS 1.2 or earlier) 
Create SMS file (SMS 2.0 or later) 


If your installation will be run in a Microsoft Systems Management Server (SMS) 
environment, you can create an .MIF file in the Windows directory to describe your 
application. MIF stands for Management Information Format. 


Install MIF Filename 


Po 


(ces J ren ] C crea J (Hop) 


7. From the SMS Distribution Panel, configure settings as necessary and click Next. The Network Location 
Panel opens. 


InstallShield Distribution Wizard 


Network Location 
Specify the network location to distribute the installation package 


Then installation will be copied to the network directory that you specify. Click Browse to 
choose the network location. 


Network Directory: 


| erm 


mre mre 
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8. On the Network Location Panel, specify the network location to distribution the installation package 
and click Next. The Distribution Summary Panel appears. 


InstallShield Distribution Wizard 


Distribution Summary 
Displays the summary for the current distribution options. 


You have selected to distribute to a SMS, 


The Following Windows Installer package file will be distributed: 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The file will be copied to the 'Z:\' network drive. 


SMS 1.2 file 2:\PackageForTheWeb 4.pdf will be created. 


SMS 2.0 file Z:\PackageForTheWeb 4,sms will be created, 
Install MIF filename PackageForTheWeb.mif. 


mre (tee) 


9. On the Distribution Summary Panel, review the selections you made. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files, to the location specified in the 
SMS Distribution Panel. The Distribution Output Panel displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution Finished at 11-Jul-2003, 15:28:08 PM 
IEEE EE IEEE 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\Adminstu 


Back [Hep 


10. Once the distribution finishes, click Finish to exit the Distribution Wizard. 
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Any associated transforms are merged into the Windows Installer package before the package is distributed to SMS. 


SMS File Templates 


The following templates are used when creating SMS files: template.pdf (for SMS 1.2) and template.sms (for SMS 2.0). 
You can find these files in the C:\AdminStudio Shared\Templates folder. You can replace or modify these templates 
and any instances of the predefined variables (below) will be replaced. 


Example 


The following table displays a PDF file template in the left column, and the output of that PDF file in the right 


column: 
Template Output 
[PDF] [PDF] 


Version=1.0 


[Package Definition] 
Product=%PRODUCT% 
Version=%VERSION% 
Comment=%MANUFACTURER% 
SetupVariations=Typical, Automated 


[Typical Setup] 

CommandName=Typical Installation 
CommandLine=msiexec /i %CMDLINE% 
UserInputRequi red=TRUE 
SynchronousSystemExi tRequi red=TRUE 
SupportedPlatforms=win 9x, Win NT (1386) 


[Automated Setup] 

CommandName=Automated Installation 
CommandLine=msiexec /i %CMDLINE% /q 
UserInputRequi red=FALSE 
SynchronousSystemExi tRequi red=TRUE 
SupportedPlatforms=win 9x, Win NT (1386) 


[Setup Package for Inventory] 
InventoryThisPackage=FALSE 


Version=1.0 


[Package Definition] 

Product=Orca 
Version=1.50.2600.0000 
Comment=Microsoft Corporation 
SetupVariations=Typical, Automated 


[Typical Setup] 

CommandName=Typical Installation 
CommandLine=msiexec /i orca.msi 
UserInputRequi red=TRUE 
SynchronousSystemExi tRequi red=TRUE 
SupportedPlatforms=win 9x, Win NT (1386) 


[Automated Setup] 

CommandName=Automated Installation 
CommandLine=msiexec /i orca.msi /q 
UserInputRequi red=FALSE 
SynchronousSystemExi tRequi red=TRUE 
SupportedPlatforms=win 9x, Win NT (1386) 


[Setup Package for Inventory] 
InventoryThisPackage=FALSE 
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Supported Variable Names 


Below is a list of supported variable names and what they map to in the PDF/SMS files. 


These variable names are case sensitive. 


Variable Name Value SMS 1.2 (.PDF) SMS 2.0 (.SMS) 

%PRODUCT% MSI ProductName [Package Definition] Product [Package Definition] Name 

%VERSION% MSI ProductVersion [Package Definition] Version [Package Definition] Version 

YMANUFACTURER% MSI Manufacturer [Package Definition] [Package Definition] 
Comment Publisher 

%CMDLINE% MSI filename + transforms N/A [SetupVariation] 


CommandLine 


%MIF% MIF filename specified in N/A [Package Definition] 
Wizard MIFFilename 
YLANGUAGE% MSI ProductLanguage N/A [Package Definition] 
converted into text Language 
%PRODUCTCODE% MSI ProductCode N/A [SetupVariation] 
UninstallKey 
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Preparing for LANDesk Distribution 


With LANDesk distribution, the MSI package along with all the setup files are compressed into a single CAB file, and 
a script file (.ini) is created. Then, the compressed setup files are copied to a network location. 


To prepare your package for LANDesk distribution: 


1. Launch the Distribution Wizard. The Distribution Wizard Welcome Panel opens. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk, 


Click Next to proceed, 
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2. On the Welcome Panel, click Next. The Installation Package Information Panel opens. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 
Specify the installation file (.MSI) you want to distribute and click the Next button, 


Windows Installer Package (.msi) 


i 9] Cee) 


Additional Transforms 


3. On the Installation Package Information Panel, click the Browse button and locate the Windows Installer 
Package (.msi) you want to distribute. 


4. If there are transforms associated with the package, click the Add button in the Additional 
Transforms area and navigate to the transform you want to add. Repeat as necessary. 


5. After specifying the package location, click Next. The Distribution Type Panel opens. 


InstallShield Distribution Wizard 


Distribution Type 
Specify the type of distribution: Network Location, FTP, Administrative Installation, 
Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 
proceed, 


Distribution Type: 


i 
fLanDesk 
Description 


Create a single compressed file and custom script file For LANDesk distribution. 


(cise Jone) (Coane) (he) 
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6. From the Distribution Type Panel, select LANDesk and click Next. The LANDesk Integration Panel 
opens. 


InstallShield Distribution Wizard 


LANDesk Integration 
Specify the parameters for LANDesk distribution. 


>>> 
LANDesk 


Specify locations for created files. You also have the option of specifying additional Windows 


Installer command line options. 


Network Directory: 


Custom Script Location: 


Windows Installer Command Line: 


Browse... 
Browse... 


7. In the Network Directory field on the LANDesk Integration Panel, specify the network location where the 
CAB file will be created. The Network Directory could be a URL or a UNC path. This field will default to 
the last used path, and will provide a most recently used list. 


8. In the Custom Script Location field, specify the location where the custom script file 
(<packageName>.INI) will be created. This INI file will contain the following format: 


[MACHINES] 


REMEXECO=C:\Idclient\sdclient.exe /p=<Compressed Cab File> " /msi /cmds=<command 


line options> 


9. By default, a template INI file will be used for creating the custom script file. This field will default to the 
last used path, and will provide a most recently used list. 


10. In the Windows Installer Command Line field, enter any command-line arguments for the MSI package. 
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11. Click Next. The Distribution Summary Panel opens. 


InstallShield Distribution Wizard 


ee » 
Distribution Summary 
Displays the summary for the current distribution options. LANDesk: 
SOFTWA E 


You have selected to distribute to a LANDesk Package. 


The Following Windows Installer package file will be distributed; 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The File will be copied to the 'Z:\' network drive. 
Custom script will be created in 'Z:\'. 
‘Windows Installer command line: ", 


| aE) 


12. On the Distribution Summary Panel, review the selections you made. If you are satisfied with them, click 
Next to distribute the package, including associated transforms and files. The Distribution Output Panel 
displays progress during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution Finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\Adminstu 


13. Once the distribution finishes, click Close to exit the Distribution Wizard. 
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Deploying an MSI Using an InstallShield 
Script-Based Setup.exe 


Many installation packages, such as Corel Draw 11, have adopted a script-driven MSI for their software packaging. 
When deploying an InstallScript MSI setup, the file setup.exe needs to be deployed with the MSI package. Setup.exe 
launches a file called isscript.msi that, in turn, installs the InstallScript engine required to run InstallScript code. This 
topic discusses how to install an InstallScript MSI setup without using setup.exe. 


To deploy a script-driven MSI using Active Directory (or another deployment method that requires the MSI format), 
you must configure the setup and the target system in the folowing manner: 


5 


To deploy an MSI using an InstallShield script-based setup.exe 


1. First install ISScript.msi (may be ISScript8.msi depending on what version the setup was created with). 


ISScript.msi is located in the same folder as the MSI package and can be deployed on the target 
machine. This installs the InstallScript engine ahead of time before the MSI package is deployed. 


2. Use AdminStudio's Tuner or InstallShield DevStudio's Transform project to create a transform. Make the 
following modifications in the transform: 


a. Add the property ISSETUPDRIVEN to the property table via the Direct Editor and give it a value of 
1. 


b. Add a condition to the "OnCheckSilentinstall" custom action in the InstallExecuteSequence via the 
Direct Editor that will always resolve to false or remove the custom action from the sequence. 


c. Make any additional changes in the transform, such as populating the serial number, modifying 
shortcuts or feature states. 


3. Next deploy the MSI package. 


4. |f deploying the package via Active Directory, make sure that you set the Installation User Interface to 
Basic and specify any transforms that you created for the MSI package. 
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Distribution Wizard Reference 


The Distribution Wizard provides a straightforward way to distribute a Windows Installer package (.msi)—including 
any associated transforms—to a network location, FTP server, administrative location, Marimba channel, via a Tivoli 
ot SMS software package definition file, via LANDesk distribution, or via Altiris distribution. 


Welcome Panel 


The Distribution Wizard provides a straightforward way to distribute a Windows Installer package (.msi)—including 
any associated transforms—to a network location, an FTP server, an administrative location, a Marimba channel, or 
via a Tivoli or SMS software package definition file. 


InstallShield Distribution Wizard 


Welcome to the InstallShield Distribution Wizard 


This wizard enables you to move your Windows Installer 
installations to either a Network Location, FTP Location, 
Administrative Install Location, Marimba channel, Tivoli, 

SMS, or LANDesk. 


Click Next to proceed, 


Click Next to proceed to the Installation Package Panel. 
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Installation Package Information Panel 


In the Windows Installer Package (.msi) field, specify or browse to the Windows Installer package (.msi) that you want 
to distribute. 


InstallShield Distribution Wizard 
Installation Package Information 
Select the Windows Installer package that is ready to be distributed. 


Specify the installation file (.MSI) you want to distribute and click the Next button. 


Windows Installer Package (.msi) 


| Additional Transforms 


In the Additional Transforms area: 


m If there are transforms associated with the package, click the Add button 
want to add. 


and navigate to the transform you 


m Use the Up and Down arrows to set the order in which the transforms are applied to the package. 


m Use the Delete button [x] to delete a transform from the list. 


Click Next to proceed to the Distribution Type Panel; click Back to return to the Welcome Panel. 
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From the Distribution Type panel, you can select the distribution method you want to use. 


InstallShield Distribution Wizard 


Distribution Type 


Specify the type of distribution: Network Location, FTP, Administrative Installation, 


Marimba, Tivoli, SMS or LANDesk 


Specify the type of distribution you want to perform from the given list and click Next to 


proceed, 


Distribution Type: 


fNetworkLocation oo i ] a i —_ a 5 B 7 ~] 


Description 


Distribute into a network directory. 


You can choose one of the following distribution methods: 


13 Preparing Packages for Distribution 


Method 


Description 


Network Location 


Distribute into a network directory. 


FTP Location 


Distribute to an FTP server, providing both your user name and password. 


Administrative Install 


The installation is copied to a network directory using the administrative install option 
provided by Windows Installer. 


Marimba A new Marimba channel is created and files are copied to it for distribution. 

Tivoli The Distribution Wizard copies the MSI, any MSTs, and the Tivoli SPD file to the network 
location specified. 

SMS The Distribution Wizard will create a Package Definition File. SMS 1.2 or earlier uses a 
.pdf file extension, and SMS 2.0 or later uses an .sms file extension. 

LANDesk Distribution for LANDesk involves creating a script file (.ini) and copying the compressed 
setup files to a network location. 

Altiris Distribution for Altiris involves creating an XML file required for Altiris, copying the MSI 


setup and the files to a network location, and copying the XML file to the same network 
location. 


InstallShield Software Corporation © 2004 


1015 


AdminStudio 5.5 User Guide 13 Preparing Packages for Distribution 


Click Next to proceed to the associated distribution method panel (Network, FTP, Administrative Install, Marimba, 
Tivoli, SMS, LANDesk), or Altiris); click Back to return to the Installation Package Panel. 


Network Location Panel 


This panel is displayed when you choose the Network Location or SMS distribution methods from the Distribution 
Type Panel. The installation files will be copied to the network directory you specify (or browse to) in this panel. 


InstallShield Distribution Wizard 


Network Location 
Specify the network location to distribute the installation package 


Then installation will be copied to the network directory that you specify, Click Browse to 
choose the network location. 


Network Directory: 


| J Cee 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type or SMS 
Distribution Panel. 
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FTP Location Panel 


This panel is displayed when you select FTP Location as the distribution method from the Distribution Type Panel. 
The installation will be upload to the FTP server specified in the FTP Location field. If necessary, provide a user 
name and password for the FTP server. 


InstallShield Distribution Wizard 


FTP Location 
Specify the FTP location to distribute the installation package 


You can upload this information to an FTP server. 


FTP Location: 


Examples: Ftp: {/servername/dir or servername/dir 


User Name: 


Password: 


User name and password are case-sensitive, 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type Panel. 
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Administrative Install Panel 


This panel is displayed if you selected the Administrative Install distribution method from the Distribution Type 
Panel. The installation will be copied to the network directory using the Windows Installer administrative install 
option. 


In addition to specifying or browsing to the location where to perform the administrative installation, you can also 
select the Use short file names option to force the administrative installation to use the 8.3 file name convention 
(using the SHORTFILENAMES property). 


InstallShield Distribution Wizard 


Administrative Install 
Specify the network location to distribute the installation package 


The installation will be copied to the network directory using the Administrative install option 
provided by Windows Installer, Choose the directory and click Next to proceed. 


v | Browse... 


Network Directory: 


Cluse short file names 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type Panel. 
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Marimba Integration Panel 


This panel is displayed if you selected the Marimba distribution method from the Distribution Type Panel. The 
information you specify in this panel enables you to create a directory to store contents for the new Marimba channel. 


InstallShield Distribution Wizard 


Marimba Integration 


7 e 
Specify the channel creation and publishing parameters m arimba 


Specify the type of distribution you want to perform From the given list and click Next to 
proceed. 


Channel Creation 


Include all the files that are in the same directory as the Windows Installer package 


Channel Publishing (Optional) 
Specify the destination channel URL on the transmitter: 


E 


Cancel Help 


This panel contains the following properties: 


Field Description 
Specify the directory Specify or browse to the directory where you want to place the contents of the new 
where you want to channel. 


place the contents of 
the new channel 


Include all the files that Select to include all files in the same directory as the installation package in the new 


are in the same directory. If this option is selected, all the files and folders in the same directory as the MSI 
directory as the package will be copied into the Channel Directory. 

Windows Installer 

package 

Specify the destination This field defines the destination channel URL and subdirectory on the transmitter. This is an 
channel URL on the optional field. However, if you specify a value in this field, you must also specify the 
transmitter channel copier URL. 

Advanced Click to access the Marimba Advanced Options Dialog, where you can specify advanced 


Marimba options for Channel Publishing and Channel Creation. 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type Panel. 
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Advanced Marimba Options Dialog 


On this dialog, you can specify advanced Marimba options for Channel Creation and Channel Publishing. 


® Advanced Marimba Options 


Specify advanced Marimba options for Channel Creation and Channel Publishing. 


Default Channel Creation Settings 
Specify the Application Package URL 


TestSomething l ~ | 


Specify the XML template file: 


C:AMlnstallShield AdminStudio\Current\Support\MarimbaMS|package ~] 


Default Channel Publishing Settings (Optional) 
Specify the channel copier URL 


TestChannelCopierIRL1234 v | 


Specify the following properties: 


Property Description 


Specify the Application Accept the default application package URL or enter a new one. 
Package URL 


Specify the XML The XML template file sets properties for the MSI file during Marimba distribution. Accept 
template file the default XML template file that was shipped with AdminStudio, or enter a new one. 
Specify the channel If you have specified a destination channel URL on the transmitter on the Marimba 
copier URL Integration Panel, then specify the URL for the channel copier in this field. 
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Tivoli Integration Panel 


This panel is displayed if you selected the Tivoli distribution method from the Distribution Type Panel. You can 
specify or browse to the network location where you want to store the installation package. All installation files— 
including the Tivoli SPD file—will be copied to this location. 


InstallShield Distribution Wizard 


Tivoli Integration s m 
Specify the network location to store the installation package. OIN software 


The product information is imported from the MSI file, 
Product Name: PackageForThewWeb 4 
Product ¥ersion: 4.0.0 


Manufacturer: InstallShield Software Corporation 


The installation and the Tivoli SPD file will be copied to the network directory that you specify. 
Click Browse to choose the network location. 


Network Directory: 


v | Browse... 


Click Next to proceed to the Tivoli Settings Panel; click Back to return to the Distribution Type Panel. 
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Tivoli Settings Panel 


You use the Tivoli Settings panel to specify the directory from which you want to launch the product installation, 
enter a source image path to bundle the images in the software packages, and specify compression settings. 
InstallShield Distribution Wizard 
Tivoli Settings 


Optionally change the install action of a feature. Tivoli. softwa re 


Specify the directory from which you want to launch the product installation. 
Target Image Path C:\AdminStudio Shared | 


Do not redirect installation to a remote system 


Enter a Source Image Path to bundle the images in the software packages. 


Source Image Path [C-\\AdminStudio Shared | 


C] Keep Images 


C] Available to All Users Compression 
© Deflated 


O Stored 


Specify the following properties: 


Property Description 


Target Image Path Specify the directory from which you want to launch the product installation. 


Redirect installation to When this option is selected, product images are not included in the Tivoli package 
a remote system because they already exist in an accessible location with the installation. 


Source Image Path Specify the path of the directory where product images are stored. When distribution 
occurs, these product images are retrieved and distributed to the target systems. This path 
is only necessary for a bundled installation, where image files are distributed with the 


package. 

Keep Images Select this option to retain the installation images on the target systems after installation. 

Available to All Users Select this option if the product should be made available to all target system users. If not 
selected, the product will only be made available to logged-on users when the installation 
is run. 

Compression Specify whether you want to use deflated or stored compression for all files and directories 


included in the Tivoli package. 


Click Next to proceed to the SPD Parameters Panel; click Back to return to the Tivoli Integration Panel. 
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This panel allows you to set the install action for each feature in the package you are distributing. These settings will 
be recorded in the Software Package Definition File (SPDF). 


InstallShield Distribution Wizard 


SPD Parameters Panel. : z 
Select parameters for the Software Package Definition File. Tivoli. softwa re 


Select the feature and click its button to change the install action for it. 


Description 


PackageForTheweb4NewFeature PackageForTheweb4NewFeature 


v| NewFeaturel 


The following install actions are possible when you click on the button to the left of the feature, although some may 
not be available depending on whether the feature supports the functionality: 


Select the feature and click its button to change the install action for it. 


N Description 

Mi PackageForT he\Web4NewFeature PackageForTheweb4NewFeature 
Set feature to local 

Set Feature and subfeatures to local 


Set Feature to advertised 
Set Feature and subfeatures to advertised 


Set Feature to absent 


Install Action Description 

Set feature to local The feature will be installed when the setup is run. 

Set feature and subfeatures to The feature and all its subfeatures will be installed when the setup is run. 
local 

Set feature to source The feature will be run from the source media. 

Set feature and subfeatures to The feature and subfeatures will be run from the source media. 

source 

Set feature to advertised The feature will be marked as advertised when the setup is run. 
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Install Action Description 

Set feature and subfeatures to The feature and all its subfeatures will be marked as advertised when the 
advertised setup is run. 

Set feature to absent The feature will not be installed when the setup is run. 


For sample input and output of an SPD file, and a description of the variables used in an SPD file, see SPD File Details. 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Tivoli Settings Panel. 


SPD File Details 


A Software Package Definition File (SPDF) named template.spd will be used when creating a new SPD file (from 
C:\AdminStudio Shared\Templates). The .SPD file will be named after the msi file name. 


Any instances of predefined variables in the file will be replaced, as described in the following table. Below the table, a 
Tivoli Sample Template File and a Tivoli Sample Output File are provided. 


In an SPD file, variables are case sensitive. 


Variable Value SPD Location 

Y%CREATION_TIME% Current date/time package \creation_time 
%MODIFICATION_TIME% Current date/time package\last_modification_time 
%ALLUSERS% yorn package \install_msi_product\all_users 
Y%REDIRECT% yorn package \install_msi_product\is_image_remote 
Y%KEEP_IMAGES% yorn package \install_msi_product\keep_images 
Y%COMPRESSION% stored or deflated package \install_msi_product\compression_method 
Y%IMAGE_DIR% Image folder path package \install_msi_product\image_dir 
Y%SOURCE_DIR% Source folder path package \install_msi_product\source_dir 
%CAPTION% MSI file path package \install_msi_product\caption 
%PACKAGE_FILE% MSI file name package \install_msi_product\package_file 
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Variable Value SPD Location 
%PRODUCTCODE% MSI ProductCode package \install_msi_product\product_code 
%PRODUCTNAME% MSI ProductName package \install_msi_product\product_name 
%VERSION% MSI ProductVersion package \install_msi_product\product_version 
Y%FEATURES% Name and install action for each — package\install_msi_product\ 

MSI feature 
Y%TRANSFORMS% Sets TRANSFORMS property in package \install_msi_product\properties 

MSI command line using 

transforms specified in Wizard. 


Tivoli Sample Template File 


"TIVOLI Software Package v4.1 - SPDF" 


package 
name = Noname 
wiele — Ino cicles 
version = 1.0 
web_view_mode 
undoable = o 
committable = o 
history_reset =n 
save_default_variables = n 
creation_time = %CREATION_TIME% 
last_modification_time = %MODIFICATION_TIME% 


hidden 


move_removing_host = y 


no_check_source_host = y 
lenient distribution = n 
default_operation = install 
server_mode = all 

operation mode = not_transactional 
post_notice = n 
before_as_uid 0 
skip_non_zero = n 
after_as_uid 0 
no_chk_on_rm = y 
versioning_type = swd 
package_type = refresh 
stop_on_failure = y 


install_msi_product 
Caption = %CAPTION% 
jimage_dir = %IMAGE_DIR% 
source_dir = %SOURCE_DIR% 
is_image_remote = %REDIRECT% 
keep_images = %KEEP_IMAGES% 
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compression_method = %COMPRESSION% 
package_file = %PACKAGE_FILE% 
reinstall_mode = file_equal_version,user_data,machine_data, shortcut 
log_mode = disabled, fatal_exit,error 
report_log =n 

ui_level = none 

product_code = %PRODUCTCODE% 
product_name = %PRODUCTNAME% 
product_version = %VERSION% 
all_users = %ALLUSERS% 

properties = '%TRANSFORMS%' 


%FEATURES% 
end 
end 


Tivoli Sample Output File 


"TIVOLI Software Package v4.2 - SPDF" 


package 
name = "MSI package" 
title = "No title" 
version = 1.0 
web_view_mode 
undoable = o 
committable = o 
history_reset =n 
save_default_variables = n 
creation_time = "2002-10-09 23:35:22" 


last_modification_time = "2002-10-09 23:46:33" 


hidden 


move_removing_host = y 


no_check_source_host = y 
lenient_distribution = n 
default_operation = install 
server_mode = all 

operation_mode = not_transactional 
post_notice = n 

before_as_uid 
skip_non_zero 
after_as_uid = 0 
no_chk_on_rm = y 
versioning_type = swd 
package_type = refresh 
stop_on_failure = y 


0 
n 


install_msi_product 
caption = C:\miky\adminpak.msi 
jimage_dir = C:\miky 
source_dir = C:\miky 
is_image_remote = n 
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end 


end 


keep_images = n 

compression_method = stored 

package_file = adminpak.msi 

reinstall_mode = file_equal_version,user_data,machine_data, shortcut 
log_mode = disabled, fatal_exit,error 

report_log =n 

ui_level = none 

product_code = {B7298620-EAC6-11D1-8F87-0060082EA63E} 
product_name = "Windows 2000 Administration Tools" 
product_version = 5.0.0.0000 

all_users = y 

properties = 'TRANSFORMS=orca.mst' 


feature 
name = Run Time Libraries 
action = default_action 


end 

feature 
name = MSI Validation Support 
action = default_action 

end 

feature 
name = Merge Module Support 
action = default_action 

end 


Click Next to proceed to the Distribution Summary Panel Panel; click Back to return to the Tivoli Settings Panel. 
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Altiris Integration Panel 


This panel is displayed if you selected the Altiris distribution method from the Distribution Type Panel. You would 
choose the Altiris method to create a package in the Altiris Notification Server. 


Field Description 


Network Directory Specify or browse to the network location where you want fo store the installation 
package. The Distribution Wizard remembers the last Network Location that is entered and 
displays it the next time this Panel is accessed. 


The Distribution Wizard will copy the Windows Installer package along with any 
transforms and files to the UNC path specified. Also, the Distribution Wizard will use an 
XML template file (AltirisTemplate.config) to create a custom script file in this location 
named <packageName>.Config. 


You can edit AltirisTemplate.config to customize it for your organization. The file, which is 
installed with AdminStudio, is located in the Templates folder of the AdminStudio Shared 
Directory. See Altiris XML Template for more information. 


Windows Installer Enter any additional properties that you want to pass to the Windows Installer. See the 
Command Line Windows Installer Property Reference for more information. 
Altiris Server Location Enter the http: address for the location of the Altiris Server. The Distribution Wizard 


remembers the last Altiris Server Location that is entered and displays it the next time this 
Panel is accessed. 


User Name Enter a User Name to log onto the server entered in the Altiris Server Location field. The 
Distribution Wizard remembers the last User Name that is entered and displays it the next 
time this Panel is accessed. 


Password Enter the password to log onto the server entered in the Altiris Server Location field. 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type Panel. 


Altiris XML Template 


When using the Altiris distribution method, a custom script file is required. If you select the Altiris method on the 
Distribution Type Panel, the Distribution Wizard uses an XML Template file (AltirisTemplate.config) to create a 
custom script file named <packageName>.Config. The Distribution Wizard copies this configuration file along with 
the Windows Installer package with any transforms and files to the Network Directory specified on the Altiris 
Integration Panel. 


You can edit AltirisTemplate.config to customize it for your organization. The file, which is installed with 
AdminStudio, is located in the Templates folder of the AdminStudio Shared Directory. 
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The following variables are used in the AltirisTemplate.Config file: 


Variable Value 
%DIST.ASVERSION% AdminStudio version number 
%DIST.COMMANDLINE% Command line specified on the Altiris Integration Panel of the Distribution 


Wizard. See the Windows Installer Property Reference for more information. 


%DIST.NETWORKLOCATION% Network location of the MSI package as specified on the Altiris Integration 
Panel of the Distribution Wizard 


%ProductCode% ProductCode property from the MSI Property Table 
%ProductName% ProductName property from the MSI Property Table 
%ProductVersion% ProductVersion property from the MSI Property Table 
YSUMMARYSTREAM.1d% Comments property from the MSI Summary Stream. 


Any property with the SUMMARYSTREAM prefix will be populated based on 
the MSI Summary Information Stream Property as specified by the Id, in the 
format of: 


<description>%SUMMARYSTREAM. 4%</description> 


Summary Stream Ids range from 1 to 19. For a complete list of Summary 
Information Stream Ids, see Summary Information Stream Property Set. In the 
example above, "4" indicates that the value of the Author property should be 
inserted. 


Please note the following: 


m Any property with the DIST prefix will be custom populated by the Distribution Wizard. 
m Any other property will be populated based on the MSI Property Table. 
m ‘Typically, all variables are enclosed within '%' characters, as shown above. 
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This panel is displayed if you selected the SMS distribution method from the Distribution Type Panel. 


InstallShield Distribution Wizard 


SMS Distribution 
Configure the parameters for SMS. 


Å package definition file is a text file that contains all the information necessary to create a software 
distribution package for an application. SMS 1.2 or earlier uses PDF file extension. SMS 2.0 or later 
uses SMS file extension. 


C Create Package Definition File (SMS 1.2 or earlier) 
Create SMS file (SMS 2.0 or later) 


If your installation will be run in a Microsoft Systems Management Server (SMS) 
environment, you can create an .MIF file in the Windows directory to describe your 
application. MIF stands for Management Information Format. 


Install MIF Filename 


[cbse Jien ] (tan) (He) 


For SMS distribution, you create an SMS PDF (package definition file): a text file that contains all of the information 
necessary to create a software distribution package for an application. 


A 


For detailed information on SMS template files and the variables they use, see SMS File Templates. 


Property Description 

Create Package Definition File (SMS 1.2 or Select this option if you are using SMS 1.2 or earlier (which uses a 
earlier) .pdf file extension). 

Create SMS file (SMS 2.0 or later) Select this option if you are using SMS 2.0 or later (which uses a 


.sms file extension). 


Install MIF Filename If your installation will be run in a Microsoft Systems Management 
Server (SMS) environment, you can create a MIF (Management 
Information Format) file in the Windows directory to describe your 
application. In this text box, insert a filename for this MIF file. This 
is an optional step. 


This field is enabled when the Create SMS file (SMS 2.0 or 
later) option is selected. 
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Click Next to proceed to the Network Location Panel; click Back to return to the Distribution Type Panel. 


LANDesk Integration Panel 


With LANDesk distribution, the MSI package along with all the setup files are compressed into a single CAB file, and 
a script file (.int) is created. Then, the compressed setup files are copied to a network location. 


If you select LANDesk on the Distribution Type Panel, the LANDesk Integration Panel is displayed. 


InstallShield Distribution Wizard 


> »> 
LANDesk Integration 
Specify the parameters for LANDesk distribution. LANDesk: 


Specify locations for created files. You also have the option of specifying additional Windows 
Installer command line options. 


Network Directory: 


| f f x] Browse... 


Custom Script Location: 


v | Browse... 


Windows Installer Command Line: 


Specify the following fields on the LANDesk Integration Panel: 


Property Description 
Network The MSI package along with all the setup files will be compressed into a single CAB file. Specify 
Directory the network location where the CAB file will be created. The Network Directory could be a URL or 


a UNC path. This field will default to the last used path, and will provide a most recently used list. 


Custom Script Specify the location where the custom script file (<packageName>.INI) will be created. This INI file 
Location will contain the following format: 
[MACHINES] 


REMEXECO=C:\Idclient\sdclient.exe /p=<Compressed Cab File> " /msi 
/cmds=<command line options> 


By default, a template INI file will be used for creating the custom script file. This field will default to 
the last used path, and will provide a most recently used list. 


Windows Installer Enter any command-line arguments for the MSI package. 
Command Line 


Click Next to proceed to the Distribution Summary Panel; click Back to return to the Distribution Type Panel. 
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Distribution Summary Panel 


The Distribution Summary Panel displays a summary of all settings configured in the previous panels. 


InstallShield Distribution Wizard 


Distribution Summary 
Displays the summary for the current distribution options. 


You have selected to distribute to a SMS, 


The Following Windows Installer package file will be distributed: 
C:\AdminStudio Shared\PackageForTheWeb 4.msi 


The file will be copied to the 'C:\AdminStudio Shared’ network drive, 
SMS 1.2 file C:\AdminStudio Shared\PackageForThewWeb 4.pdf will be created, 


SMS 2.0 File C:\AdminStudio Shared\PackageForThewWeb 4.sms will be created, 
Install MIF filename Package4Web.mif, 


When you click Next, the distribution begins and the Distribution Output Panel is displayed. Click Back to return to 
the panel for the corresponding distribution type. 


The distribution will overwrite the contents of the distribution folder. 
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The Distribution Output Panel displays a progress bar and status messages during distribution. 


InstallShield Distribution Wizard 


Distribution Output 
Displays the status messages for the current distribution. 


Distribution finished at 11-Jul-2003, 15:28:08 PM 


Packaging started on 11-Jul-2003, 15:28:08 PM 
Copying files From 'C:\AdminStudio Shared’ --> 'C:\AdminStudio Shared’ 
Copying 'C:\AdminStudio Shared\ACROBATREADER.MSI' --> 'C:\Adminstu 


When distribution completes, click Finish to exit the Wizard. 


For all distribution types, the Distribution Wizard will create a Distribution log file in the Distribution folder of the 
AdminStudio Shared Directory. 
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Tutorial Overview 


The AdminStudio Application Migration Tutorial covers the entire application migration process, from repackaging a 
traditional setup, to converting it to a Windows Installer installation, customizing it, and checking it against a database 
for potential conflicts. 


An InstallShield DevStudio Basic MSI Tutorial is available online at: 
hitp://helpnet.installshield.com/Robo/BIN/Robo.dll?tpc=/robo/projects/devstudio9helpmsitutorial/TutorialTop.htm. 


An InstallShield DevStudio Globalization Tutorial is available online at: 
http://helpnet.installshield.com/Robo/BIN/Robo.dll?tpc=/robo/projects/helplibdevstudio?/GlobalizationTutorial.htm 


This tutorial guides you through a basic application migration process, including repackaging, modifying the resulting 
MSI in DevStudio, customizing, and identifying and solving conflicts. The following steps are covered: 


= Preparation a Customizing an Installation Using Tuner 
Opening the Package and Creating a Transform 
Prevalidation 

Customization 

Postvalidation 

Packaging 

Further Customizations 


= Repackaging 
Launching Repackager Remotely 
Repackaging a Traditional Installation 
Customizing the Captured Data 
Building the DevStudio Project and MSI Package 


= Modifying and Building a Windows Installer 
Installation 
Modifying the Project 
Adding a File and Setting the Key File 
Building the Release 


= Identifying and Resolving Conflicts 
Opening ConflictSolver and Accessing the Database 
Configuring ConflictSolver Options 
Creating a Group and Importing a Package 
Identifying Conflicts 
Resolving Conflicts and Reimporting the Package 
Checking for Conflicts a Second Time 


Prior to running this tutorial, you need to install AdminStudio on a development machine. You also need to prepare a 
clean machine on which you will repackage the setup used in this tutorial. 


The tutorial is organized into four main steps: repackaging, enhancing the Windows Installer package, tuning, and 
identifying and resolving conflicts. During each step, you save your output to existing folders included with the 
AdminStudio installation. 


For purposes of this tutorial, <AdminStudio Directory> represents the directory in which AdminStudio is installed. 
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Repackaging 


The first step in the Application Migration/Pre-Deployment process is to repackage a legacy setup. For purpose, you 
are going to repackage PackageForTheWeb 3 from InstallShield. This involves not only running the Repackaging 
Wizard to capture the data, but also configuring options, excluding data, and building the repackaged setup into an 
InstallShield DevStudio project. 


Launching Repackager Remotely 


The first step in this tutorial is to install the standalone version of Repackager on a production system, and then 
launch the Repackager remotely from a clean system. A clean system is essential so that all changes are captured 
correctly and ultimately converted into a Windows Installer package. 


{or ) 


(ii 


To launch the Repackager remotely: 


1. Ona production machine that does not contain AdminStudio, download and install a standalone 
version of InstallShield Repackager. To download the Repackager installation setup, go to the following 
URL: 


http://support. installshield. com/kb/fi1les/Q108601/setup.exe 


When installation is complete, the Repackager executable will be located in the following directory on 
the production machine: 
\Program Files\Instal]lShield\Repackager\islc.exe 


2. Share the Repackager directory on the production machine so it can be accessed from the network. 
This can be done by right-clicking the directory in Windows Explorer and selecting Sharing from the 
context menu. 


3. From your clean machine (where you will repackage a legacy setup), connect to the machine on which 
the standalone version of Repackager is installed. 


4. Navigate to the \Program Files\InstallShield\Repackager folder and launch islc.exe. 


5. After you have launched Repackager remotely, you need to launch the Repackaging Wizard, which 
you will use to capture the PackageFromTheWeb setup. To do so, click the InstallShield Repackaging 
Wizard link on the Start page in Repackager. 
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Repackaging a Traditional Installation 


The goal of this step is to repackage the setup into a Repackager project file, which can later be converted into a 
DevStudio project. 


— 
With the Repackaging Wizard launched as described in the tutorial topic Launching 
Repackager Remotely: 


1. Launch the Repackaging Wizard as described in the tutorial topic Launching Repackager Remotely. The 
Repackaging Wizard Welcome Panel opens. 


InstallShield Repackaging Wizard 


Welcome to InstallShield Repackaging Wizard 


This wizard enables you to create a completely new 
installation for an existing, packaged application, It can 
also create an installation project that can be further 
enhanced using InstallShield DevStudio. 


e \ For optimal use, InstallShield Repackaging Wizard 
Jy should be run remotely from a mapped location. 
See the Help Library topic "Repackaging Wizard 
Best Practices" for details, 
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2. Click Next. The Method Selection Panel opens. 


InstallShield Repackaging Wizard 


Method Selection 
Select 4 repackaging method. 


Repacker watches lower-level system activities and records related changes made to the 
system by the setup program(s). It then analyzes these activities and stores the setup 
data in an output file which can be converted into a Windows Installer package. 


© Snapshot 


Repackaging Wizard takes an initial snapshot of the local system, runs the setup 
program(s}, and then takes a second snapshot, The difference between the two 
snapshots is stored in an output file which can be converted into a Windows Installer 
package. 


3. In the Method Selection Panel, select Installation Monitoring and click Next. The Collect Product 
Information Panel opens. 


InstallShield Repackaging Wizard 


Collect Product Information 


Provide product information for repackaging, Items with asterisks (*) are 
required. 


Setup Programs 


*Program File: 


Command-line 
Argument(s): 


Edit Setup List 


Product Information 


*Product Name: | Version: 


Product URL: http://www. installshield, | Support URL: | http://www. installshield, 


Company Name: | InstallShield Software Corporation 


4. In the Collect Product Information Panel, provide product information as follows: 


a. Click the Browse button (...) to the right of the Program File field and browse over the network to 
<AdminStudio Directory>\Tutorial\Repackager\PackageForTheWeb 3 directory and select 
PackageForTheWeb3.exe. When you return to the Collect Product Information Panel, the name of 
the selected file appears in the Program File field, and information is automatically entered in the 
Product Information area. 
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b. In the Product Information area, ensure the following values are entered: 


Product Name PackageForTheWeb 3 
Version 3.00 

Product URL http://www. installshield.com 
Support URL http://www. .installshield.com 
Company Name InstallShield Software Corporation 


5. Click Next. The Set Target Project Information and Capture Settings Panel opens. 


InstallShield Repackaging Wizard 


Set Target Project Information and Capture Settings 
Provide the target project path and review capture settings. 


Specify the location where Repackaging Wizard will store files created during system change 
analysis, The Repackaging Wizard output file (inc) will be saved to this location. 


Project path to store files 
C;\Packages\I5OnTheWebTest 


Review or edit the current settings 


Any changes made to these settings will apply to the current and 
Future analysis, 


6. On the Set Target Project Information and Capture Settings Panel, click the Browse button (...) and 
navigate to <AdminStudio Directory>\Tutorial\Repackager\Output. 
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7. Click Edit to change the capture settings. The Analysis Options Dialog opens. 


Analysis Options 


Capture types 


: Shortcuts 
[C] Deleted files Reaistry data 
INI files [C] Deleted registry data 


C] Non-.ini extensions 


Restrict directory analysis to the following [Snapshot mode only): 


lew Edit 


8. In the Analysis Options Dialog, ensure Files, Shortcuts, INI files, and Registry data are selected, and 
Deleted files, Non-.ini extensions, and Deleted registry data are cleared. The four selected capture 
types ensure proper data is captured during repackaging; the three cleared capture types rarely occur, 
and can be ignored for this tutorial. 


9. Click OK to close the Analysis Options dialog and return to the Set Target Project Information and 
Capture Settings Panel. 


10. Click Start. The Repackaging Panel opens displaying the repackaging progress. 


InstallShield Repackaging Wizard 


Repackaging ... 
Please wait while InstallShield Repackaging Wizard performs system analysis. [m;e] 


InstallShield Repackaging Wizard is analyzing your system and setup(s) ... 


Analyzing the system state changes... 
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When the initial system status analysis completes, the PackageForTheWeb 3 extraction Welcome Panel 
appears prompting you to run the setup. 


eu PackageForTheWeb 3 - InstallShield Wizard 


Welcome to the InstallShield Wizard 
for PackageForTheWeb 3 


The InstallShield Wizard(TM) will help install 
PackageForTheWeb 3 on your computer. To continue, click 
Next, 


Cancel | 


11. On the PackageForTheWeb3 extraction Welcome Panel, click Next to extract the program. After 
extracting PackageForTheWeb, the PackageForTheWeb 3 Installation Welcome Panel appears. 


PackageForTheWeb 3 - InstallShield Wizard 


Welcome to the InstallShield Wizard for 
PackageForTheWeb 3 


The InstallShield® Wizard will install PackageForT hew'eb 
3 on your computer. To continue, click Next. 
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12. On the PackageForTheWeb 3 Installation Welcome Panel, click Next. The License Agreement Panel 


opens. 


PackageForTheWeb 3 - InstallShield Wizard 


License Agreement 
Please read the following license agreement carefully. 


SINGLE DEVELOPER END-USER LICENSE AGREEMENT FOR InstallShield® or 
DemoShield® SOFTWARE 


IMPORTANT-READ CAREFULLY. This InstallShield End-User License Agreement 
“EULA") is a legal AGREEMENT between you (either as a registered individual developer 
or as the registered developer/representative and on behalf of a single entity) and 
InstallShield Software Corporation for the InstallShield software product identified above, 
which product includes computer software and may include associated media, printed 
materials, and “online” or electronic documentation ("SOFTWARE PRODUCT"). By 
installing, copying, or otherwise using the SOFTWARE PRODUCT, you agree to be 
bound by the terms of this EULA. If you do not agree to the terms of this EULA, then DO 
NOT install or use the SOFTWARE PRODUCT; in such event the original purchaser may, 


© | do not accept the terms of the license agreement 


InstallShield 


<Back Can 


PackageForTheWeb 3 - InstallShield Wizard 


Customer Information 
Please enter your information. 


Please enter your name and the name of the company for whom you work. 


User Name: 


InstallShield Software Corp 


Company Name: 


[Installs hield Software Corp 


InstallShield —— 


Canc 
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14. In the Customer Information Panel, enter your name and your organization's name. Click Next. The 
Destination Folder Panel opens. 


PackageForTheWeb 3 - InstallShield Wizard 


Destination Folder 
Click Next to install to this folder, or click Change to install to a different folder. 


Install PackageForT heWeb 3 to: 
C:\...MinstallShield\PackageForT heWeb 3 


15. Click Next on the Destination Folder Panel. For this installation, allow PackageForTheWeb to install in 
its default location. The Ready to Install the Program Panel opens. 


PackageForTheWeb 3 - InstallShield Wizard 


Ready to Install the Program 
The wizard is ready to begin installation. 


Click Install to begin the installation. 


If you want to review or change any of your installation settings, click Back. Click Cancel to exit 
the wizard. 
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16. From the Ready to Install the Program Panel, click Install. The Setup Status Panel opens. 


PackageFor TheWeb 3 - InstallShield Wizard 
Setup Status 


PackageForTheWeb 3 Setup is performing the requested operations. 


Installing: Copying program files... 


InstallShield 


When installation is complete, the InstallShield Wizard Complete Panel opens. 


PackageForTheWeb 3 - InstallShield Wizard 


InstallShield Wizard Complete 


The InstallShield Wizard has successfully installed 
PackageForTheWeb 3. 


You can run PackageForT heWeb 3 and view the Readme file 
now by selecting these options below. 


I View the Readme file. 


Click Finish to exit the wizard. 


Cancel | 
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17. From the InstallShield Wizard Complete panel, ensure both options are cleared and click Finish. You 
are returned to the Repackaging Panel and are prompted to analyze system status changes. 


InstallShield Repackaging Wizard 


Repackaging ... 
Please wait while InstallShield Repackaging Wizard performs system analysis. [m0] 


InstallShield Repackaging Wizard is analyzing your system and setup(s) ... 
All setups) have been launched. 
Once the installation is complete, you may make additional changes to the system such 


as deleting Files and shortcuts, Click Process when you are ready to complete the 
repackaging process. 


18. Click Process to complete the Repackaging process. When the Wizard finishes, the Summary Panel 
opens. 


InstallShield Repackaging Wizard 


Summary 


Review the summary information below, Click Finish to exit Repackaging 
Wizard, 


Summary: 


Repackaging Method: Installation Monitoring 
Product Name: PackageForThewWeb 3 


Output Files: 


Output file created: C:\Program Files\InstallShield\AdminStudio\S.5\ Tutorial 
\Repackager\Output\PackageForThewWeb 3, inc 


Next Steps: 


Click Finish to launch the Repackager to edit and build your project. 


19. Click Finish. 
The SmartScan Wizard is launched to scan this InstallShield Professional media for setup information that may not 


have been captured during repackaging, such as possible additional files, INI files, shortcuts, or registry data. Run the 
SmartScan Wizard as described in Scanning InstallShield Professional Setups. 
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After repackaging, all files necessary for conversion to a Windows Installer package are located in the folder specified 
in the Set Target Project Information and Capture Settings Panel (in <AdminStudio 
Directory>\Tutorial\Repackager\Output). The Repackager Interface opens with the newly created Repackager 
project PackageForTheWeb 3.irp. 


PackageForTheWeb 3.irp - InstallShield Repackager 
File view Project Build Tools Help 


Captured Installation 
__] Files and Folders oP Summary 
@y Registry Entries 
Ez] Shortcuts Captured Installation Summary 
B-A Repackaged Output 
Package Information Operating System: Windows XP, version 5.1.2600 Service Pack 1 (English) 
Advanced Settings 


Path to original setup: C:\... \Repackager\PackageForTheWeb 3\PackageForThewWeb3.exe 


Original target folder: | [ProgramFilesFolder]InstallShield\PackageForThewWeb 3 


[O] 53 files G 2 shortcuts 


Ef 397 registry entries “> QINI file entries 


Captured Installation Tasks 


E| Create setup capture report 
Generate an HTML or text document that summarizes the captured setup data. 


Scan for setup intent 
Analyze the captured setup data For missing files and files that the original setup intended to deploy. 


This setup was created with InstallShield Professional. 


Scan the InstallShield Professional setup For platform-dependent setup information. 
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Customizing the Captured Data 


After the Repackaging Wizard finishes, Repackager opens the PackageForTheWeb 3.irp file, which is the Repackager 
project for the captured data. From Repackager, you can view the captured files, folders, shortcuts, and registry 
entries. Notice that, despite configuring the Repackaging Wizard to capture INI file changes, none are recorded in the 
Repackager project file. This is because there were no changes made to any INI files during the PackageForTheWeb 
setup. 


For purposes of this tutorial, you are going to exclude one file which is unnecessary for the setup. 


oe 


FA i 


To eliminate the file from the setup you are building: 


1. Click on Files and Folders to display the Files and Folders View. 


PackageForTheWeb 3.irp - InstallShield Repackager 
File Yiew Project Build Tools Help 
BH ttes 84 & 
Sy Captured Installation Files and Folders 
MA} Files and Folders Summary 
AY Registry Entries 
k Ez] Shortcuts 
=) Repackaged Output 8 files will be excluded, 
g Package Information 


4) [ProgramFilesFolder] 
© [SystemFolder] 

E- [CommonFilesFolder] 
{©} [WindowsFolder] 


53 files were captured. 


2. Expand [ProgramFilesFolder]. 
3. Expand InstallShield. 
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4. Click on PackageForTheWeb 3. A list of files in that folder appears. 


PackageForTheWeb 3.irp - InstallShield Repackager DA) 
Eile view Project Build Tools Help 


Captured Installation B Files and Folders 
Files and Folders Summary 
> Registry Entries 
GEJ Shortcuts 
g EE Repackaged Output 7 files will be excluded. 
8 Package Information 


53 files were captured, 


Advanced Settings Exclude all 


5- [ProgramFilesFolder] Name Size (bytes) | Version Language ¢ 
5- Installshield (Jchktrust.exe 12560 5,101.1663.1 English 
Eei PackageForThewWeb 3 Q pftwlogo.gif 1888 English 
i‘) [SystemFolder] | )PFtwwie.chm 252785 English 
a commons tes acer] {_) PFtwwiz.chw 0 English 
C [WindowsFolder] C] pftwwiz.exe 1044480 3.00.17.000 English 
r readme.htm 4240 English 
O signcode.exe 27408 5.101.1663.1 English 
O signer dll 77584 5,101.1663.1 English 
O stub3ži.exe 163840 3.00.17.000 English 


< 


5. In the file list, click on Pftwwiz.chw. 
6. Click Exclude. 


When you build the Windows Installer package, Pftwwiz.chw will not be included in the MSI. However, if you find 
later that the file is necessary, you can return to the Repackager project, reinclude it, and rebuild the MSI. 
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Building the DevStudio Project and MSI Package 


Once you have finished configuring exclusions, you need to configure and build the InstallShield DevStudio project 
(ism) and Windows Installer package. This includes configuring advanced settings. 


ge 


FA - 


To configure advanced settings: 


1. Click on Advanced Settings to display the Advanced Settings View. 


PackageForTheWeb 3.irp - InstallShield Repackager 


File view Project Build Tools Help 


(Cun ttes HAS 


Captured Installation gE Advanced Package Settings 
Files and Folders Captured Data Conversion Settings 
Registry Entries 
i Ez] Shortcuts Package Conversion 
(2) Repackaged Output 
g nA Use DevStudio path variables instead of physical source paths, 
Display only the Welcome dialog during installation. 
Replace files with merge modules whenever possible. 
C] use the language captured by the Repackager as the language of the setup 


Include files from Setup Intent scan 


Component Settings 


Mark components destined for the System folder as permanent. 


Mark components destined for the CommonFiles folder as shared. 


Map registry data to the appropriate COM tables, 
[E] Map registry data to the appropriate ODBC tables. 


[C] Map NT Service events to the ServiceControl table. 


InstallShield SmartScan Settings 


Include files From InstallShield legacy media scan 


C] Exactly match legacy setup's Operating System requirements 


2. Ensure all options are selected except for the following: 


m Display only the Welcome dialog during installation 
m Use the language captured by Repackager as the language of the setup 
= Map registry data to the appropriate ODBC tables 


m Map NT Service events to the ServiceControl table 
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Once your advanced settings are configured, you can configure the repackaged output information and build the 
package and DevStudio project: 


To configure repackaged output settings and build: 


1. Click on Repackaged Output to display the Repackaged Output View. 


PackageForTheWeb 3.irp - InstallShield Repackager 
File view Project Build Tools Help 


‘OH tte BX 


Captured Installation Rep ark mat ‘Output Fë 
Files and Folders Package Settings and Conversion Options 
3 Registry Entries 
Repackaged Output Summary 


AJ Package Information DevStudio Project: | C:\Program Files\InstallShield\AdminStudio\5.5\Tutorial\Repack. | gi 
Advanced Settings 


Windows Installer Package: C:\Program Files\InstallShield\dminStudio\5.5\Tutorial\Repackager\Outy 


Repackaged Output Options 


Create a Windows Installer package (.msi) after creating the DevStudio project 
Build a compressed, single-file package that contains all of the files. 
[C] Create a Setup.exe to launch the package 


@ Use the default DevStudio template 


© Use a customized template 


2. Ensure the DevStudio Project is set to <AdminStudio 
Directory>\Tutorial\Repackager\Output\PackageForTheWeb 3.ism. 


3. Select the options to Create a Windows Installer package, and to build a compressed, single-file 
package. Clear the Create a Setup.exe option. 


4. Select to use the default DevStudio template. 


5. Click Build. 


After the build finishes, the package and project are stored in <AdminStudio 
Directory>\Tutorial\Repackager\ Output \PackageForTheWeb 3.ism. Close Repackager (saving the Repackager 
project) and launch DevStudio from the AdminStudio Interface. 
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Modifying and Building a Windows 
Installer Installation 


DevStudio, although primarily used in AdminStudio for converting Repackager output into Windows Installer 
packages, is a full-featured authoring tool. Using it, you can create new Windows Installer packages, or open existing 
Windows Installer packages and modify them, in addition to the workflow described in this tutorial. Consult 
DevStudio's online help for comprehensive authoring information. 
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Modifying the Project 


Once you use Repackager to create an .ism project, you can make customizations as necessary. For this tutorial, you 
are going to add your name as the setup author, and add some authoring comments. You are also going to add a file 
to a component and make it the key file. 


To modify the project: 


1. Launch DevStudio from the AdminStudio Interface. The DevStudio Start Page opens. 


InstallShield DevStudio - AdminStudio Edition 
JOen|Me|DO|t+es|4 Gens, G2 dDe| 
| Eje Edit view Go Project Build Tools Window Help 


Start Page Start Page 


DevStudio- 


Get Started] “€S 


D Help Library 


=] Create a new project 


O Browse sample projects 


D Support Central 
D InstallShield Community 
[> Technical FAQs 


oS Open an existing project | 


D Webinars 
[> Downloads 


Contact Us 


(2) Which project type is right 
for me? 

(2) What is the difference 
between patching and 
upgrading? 


[> Give Us Feedback 


D Join our Customer 
Experience 
Improvement Program 
and help improve the 
quality, reliability and 
performance of DevStudio 


Getting Started Upcoming Top Knowledge 

Webinars Base Articles 
Not sure where to Click an article ID 
begin? Click the How to create a to read that 
Getting Started link major or minor article, 


ka ambar kha riari AF nmamwaeda in 


| | | Num] 


(2) Where can I find help for 
error or warning codes? 


(9) Where can T learn ahniit 


2. When DevStudio opens, select Open from the File menu. 


3. Browse to the <AdminStudio Directory>\Tutorial\Repackager\Output directory. 
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4. Select PackageForTheWeb 3.ism and click Open. The DevStudio Installation Designer Tab opens. 


PackageForTheWeb 3 - InstallShield DevStudio - AdminStudio Edition [Basic MSI Project] DER) 
|Den ooann t te): 
|| File Edit View Go Project Build Tools Window Help 


Start Page Project Assistant Installation Designer Description fm 


Fy Description ror 
J- Organization Descri p tion 
+) Application Data 
© System Configuration Describe and identify your setup. 
{© Behavior and Logic 
{© User Interface 
© Media 
{© Additional Tools General Information 
Enter your product name, version, company name, and other 
information. 
Also, select which languages your setup supports. 
Read more about General Information 


See Also 


§@ Setup Design 


5. Expand the Description view in DevStudio and select General Information. The General Information 
View opens. 


PackageFor TheWeb 3 - InstallShield DevStudio - AdminStudio Edition [Basic MSI Project] BAR 
[Dorno anme ye |O 
| le Edit View Go Project Build Tools Window Help 


Start Page Project Assistant Installation Designer 


=) Description E-E] General Information 

General Information g& Project Properties 

H-E Organization p Summary Information Stream : . , 
=- Application Data eh Add/Remove Programs The General Information view provides a 
+) © System Configuration {E Product Properties place to create and edit project settings. 
=- Behavior and Logic (=| aB§ String Tables Each subview is described below, 


General Information ¥iew 


+) User Interface g? English {United States) 
#1 Media Project Properties 
=- Additional Tools 


You can use the Project Properties view 
to enter basic information about your 
setup project, such as the languages 
supported by your project. 
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6. Select Project Properties from the General Information tree. Project Properties are listed. 


E-E] General Information 
g£ Project Properties 


Summary Information Stream 


wf) Add/Remove Programs 
[E Product Properties 
5-858 String Tables 
g English (United States) 


Location 
Project File Format Binary 
Author Name 
Setup Languages 
Comments 


7. Click in the Author Name field and enter your name. 


Program Files\InstallShield\ Admin 


English (United States) 


studio'S5.5\ Tuto 


8. Click in the Comments field and enter AdminStudio Tutorial. 


9. From the File menu, select Save. 


Adding a File and Setting the Key File 


To add a file to an existing component and make it the key file: 


torial 


1. In DevStudio, expand the Organization view and select Components. The Components View opens. 


PackageForTheWeb 3 - InstallShield DevStudio - AdminStudio Edition [Basic MSI Project] 


|Den oam tte] 


& i 


|| Eie Edit view Go Project Build Tools Window Help 


Start Page Project Assistant 


=- Description 
General Information 
J- Organization 
2 Setup Design 
Features 
{3} Components 
{© Application Data 
{© System Configuration 
)- Behavior and Logic 
{© User Interface 


© Media 


1) Additional Tools 


= 


A - 


+) 


Installation Designer 


Components 
+- asycfilt. dll 
+ Th] chktrust.exe 
+- corecomp ini 
#3} ctor.dl 
+- Folder_Lanquages 
=EN) Folder_PackageForTheweb3 
+- hh.exe_COM 
+- hhetrl.ocx_COM 
+) © ikernel.exe 
#49) ilog.dll 
w- iscript. dll 
+- itircl.dll_com 
+ 


A itss.dll_COM 


C iuser dll 


7 
1-9) objectps.dil 
< Lill 


Components ¥iew 


Use the Components view to create components and 
associate properties and data elements with them. 
Components are a grouping of similar application 
data—items such as files, shortcuts, and registry 
entries—organized from the developer's perspective. 
Your users will never see components during the 
installation; the data will be set up on their systems 
depending on which features are selected for 
installation, 


Adding Components 


Components allow you to organize your application 
data into similar groups. Unlike features they constitute 


“a i ' i ea 
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2. From the Components tree, click and expand the Pftwwiz.chm component to display its views. 


PackageForTheWeb 3 - InstallShield DevStudio - AdminStudio Edition [Basic MSI Project] 


[Don oa nmts e> 


| Eie Edit view Go Project Build Tools Window Help 


Start Page Project Assistant Installation Designer 


{© Description H-S Components pftwwiz.chm Component 
General Information H- asycfilt. dil -| [Destination 
E B Organization © chktrust.exe Destination Permissions 
3 Setup Design 0 corecomp. ini Component Code 
Features A ctor.dl Shared 
{3 Components (I Folder_Languages Permanent 
{© Application Data © Folder_PackageForTheWeb3 Condition 
{© System Configuration 


@ hh.exe_COM Remote Installation 
{© Behavior and Logic A hhetrl.ocx_COM COM Fxtrack at Build 
© User Interface C) ikernel.exe SIN Destination Property 


A ilog.dll 


es 


+H FF) 


Ll 


{© Media 
{© Additional Tools 


GG) 


GA itircl.dll_com 


+- Fe) Se) Fe) Be) 


H 


oleaut32.dll_COM 


Q 
CA olepro32.dil 
@ 


D-E 


Files 
Registry Data 
(EJ Shortcuts 
H-E Advanced Settings 


C pFtwwiz.exe_COM 
Ea DanictruNsts HCD 
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[INSTALLDIR] 

0 Permissions) defined 
{A4DA34749-F023-4832-4D28- 1 BBE 
No 

No 


Favor Local 
Na 


A iscript.dl Select the folder to which this component's files 
should be installed from the drop-down menu. To 
@ itss.dl_COM install the files to the product's default destination 
O iuser. all folder, select [INSTALLDIR] from the list of Windows 
(Q objectps.dl Installer folder properties. 


Select “Browse, create, or modify a directory 
entry...” to display the Browse for Directory dialog. 
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3. Click on the Files node below Pftwwiz.chm. The files associated with Pftwwiz.chm are listed. 


PackageFor TheWeb 3 - InstallShield DevStudio - AdminStudio Edition [Basic MSI Project] 
[Don ooa nmt te] 


|| Bile Edit view Go Project Build Tools Window Help 


Start Page Project Assistant Installation Designer 


= B Description =| Components 
General Information H- asycfilt. dil 
a- Organization [ @ chktrust.exe 

3 Setup Design [ D corecomp.ini 

Features HG) ctor.dl 
A Components =) Folder_Languages 
{© Application Data & © Folder_PackageForTheWeb3 
{© System Configuration + @ hh.exe_COM 
{© Behavior and Logic [ © hhetrl.ocx_COM 
{ User Interface =) ikernel.exe 
© Media =- ilog.dll 
{© Additional Tools =E) iscript.dll 
G9 itircl.dll_com 
GA itss.dll_com 
=- iuser dll 
+- objectps.dll 
C oleaut32.dll_com 
E © olepro32.dll 
{©} pftwwiz.chm 
Registry Data 
(EJ Shortcuts 

(+) (=) Advanced Settings 
4) pftwwiz.exe_COM 


DRA DonictruMsts HYCO 
Nit 


E 
i+ 
=] 
z 
E 
(+) 


Components %% 


246 KB <SOURCEFILEP... 


4. Inthe File list, right-click and select Add. 


5. Navigate to the <AdminStudio Directory>\Tutorial\Author\Files and select Keyfile.htm. Click Open. 


6. If the Path Variable Recommendation dialog appears, select the first option for the path variable and 


click OK. Keyfile.htm appears in the File list. 
7. Right-click Keyfile.htm and select Set Key File. 


Copy Ctrl+C 
| Paste Ctrl+V 
| 
| 

Delete Del 


Properties 


8. When prompted for confirmation, click Yes. 
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Once you have made modifications to the DevStudio project, you need to build it into a Windows Installer package 
again to reflect those changes. 


ASN 
La \- 


To build the release: 
1. From the Build menu, select Build Release1. 


2. Verify the build completes successfully by monitoring the information in the Build tab of the Output 
window. 


When completed, the PackageForTheWeb 3.msi is located at <AdminStudio 
Directory> \Tutorial\Repackager\Output. Copy the PackageForTheWeb 3.msi to <AdminStudio 
Directory>\Tutorial\ Author\Output. Close DevStudio and launch Tuner from the AdminStudio Interface. 
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Customizing an Installation Using Tuner 


The Microsoft-recommended method of customizing Windows Installer-based installations is through a transform 
file. This ensures that modifications are made outside of the base package. If you intend to deploy the same 
installation to different sets of users with modifications of the installation, it is much easier to make the changes 
necessary in transform files, rather than in the original Windows Installer package. This also protects the software 
vendor's original installation from being modified incorrectly. 


Opening the Package and Creating a Transform 


(g> 
2 


Bi 


To open the base Windows Installer package and create a new transform: 


1. From AdminStudio, launch Tuner. The Welcome to InstallShield Tuner View opens. 


InstallShield Tuner 


File Edit Yiew Go Project Tools Help 


|\2G6He Dot +> maxs |G! OG 


| t Welcome 


welcome to InstallShield Tuner 


F Create a new transform 
Create a new transform file (.mst) 


| (=) Open a recent transform 
Open a recent transform file (.mst) 


| B Open an existing transform 
Open an existing transform file {.mst) 


| @ InstallShield on the Web 
| Explore InstallShield's Internet resources 
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InstallShield Today 4 


InstallShield Tuner 


welcome to InstallShield Tuner. 


InstallShield Tuner allows Systems Administrators to use task-based views 
to easily customize third party Windows-Installer based applications. Tuner 
contains everything you need to tailor and customize your application— 
without risking increased support costs from broken installations. 


You demand a higher level of control over the configuration and deployment 
of your application than comes standard with your installation wizard, You 
need a good way to restrict the options or to bypass the installation wizard 
entirely with a silent installation—while still tailoring the installation to the 
needs of individual groups or departments. You need easy ways to modify 
registry settings, change shortcuts, add files, add scripts, and set up 
database connectivity, Now there's a fine-tuned commercial solution for you 
to solve these pressing requirements. 


With InstallShield Tuner, you get all the installation flexibility you need. 
Tuner uses a Microsoft-standard approach to modify Windows Installer 
applications. Using transforms (MST files), Tuner modifies installation 
routines without damaging the original application package. Plus, 
InstallShield Tuner lets you customize any aspect of the installation using an 
elegant Outlook-style interface that keeps you from ever having to plumb 
the depths of the Windows Installer table schema. 
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2. Select Create a new transform. The Create a New Transform View opens. 


InstallShield Tuner 


|| File Edit View Go Project Tools Help 


DER) 


jpeu@|DO|t++>|Bax|eor!\/eoe 


InstallShield Today A 


Wt Welcome 
Welcome to InstallShield Tuner 


r| Create a new transform 


Create a new transform file (.mst) 


B Open a recent transform 
Open a recent transform file (.mst) 


oS Open an existing transform 
Open an existing transform file (.mst) 


@ Installshield on the Web 
Explore InstallShield's Internet resources 


Base Windows Installer Package 
Select an MSI file. 


Provide a list of additional transforms to be applied. 


Windows Installer Transforms 


Provide a new project name and location (or accept the default), and click Create to create a new 
Customization project. 


C] Response Transform 


Command line properties (separated by ';') that will be passed to the Windows Installer package 


hile creating a response transform 


3. In the Base Windows Installer Package area, click Browse and navigate to the <AdminStudio 
Directory>\Tutorial\Author\Output directory. Select the PackageForTheWeb 3.msi file and click Open. 


4. In the Windows Installer Transforms area, click Browse and navigate to the <AdminStudio 
Directory>\Tutorial\Tuner\Output directory and create a file called PFTW.mst. Click Save. 


5. Ensure the Response Transform option is cleared. 
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6. Click Create. The Package Validation View opens. 


PFTW1.mst (PackageForTheWeb 3.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


jpeu@|Dlp|t+e>|Bax~|\eor.!\e@ 


Package Validation tm 
g Pacl validation : . . 
ga porem 2 > Package Validation 
5- Organization | : 
Product Properties 
2 Features 
4 System Configuration 


Files and Folders 
Registry ram Prevalidation 


Shortcuts Head Enter your product name, version, company name, and other information, 
INI Files Also, select which languages your setup supports, 


Prevalidate your existing Windows Installer package before customizing it. 


NT Services 
ODBC Resources 
5- Application Configuration 
g Server Locations 
[0] Setup Properties 
É Dialogs 
ra) Add/Remove Programs 
5- Package Preparation 


Postvalidation 
# Package 
5- Additional Tools 
f Direct Editor 
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The first step after creating the transform file is to run prevalidation on the original Windows Installer package. 
InstallShield Tunet's prevalidation process ensures the Windows Installer package you are customizing is valid 

according to a predetermined set of guidelines. In most cases you will want to run prevalidation using Microsoft's Full 
MSI Validation Suite, a set of over 70 guidelines that ensure the package was created to Microsoft standards. 


To begin prevalidation on the base Windows Installer package: 


1. On the Tuner Package Validation View, select Prevalidation from the checklist to display the 
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Prevalidation View. 


PFTW1.mst (PackageForTheWeb 3.msi) - InstallShield Tuner 


DebHa@|DloO|t+e> | Baxrleoe! 


| File Edit View Go Project Tools Help 
| 
j 


| 5- Package validation 
S- Organization 
Product Properties 
B Features 
| & © System Configuration 
Files and Folders 
Registry 
OF Shortcuts 
A INI Files 
NT Services 
3 ODBC Resources 
S Application Configuration 
Server Locations 
[E] Setup Properties 
É Dialogs 
B Add/Remove Programs 
| 5- Package Preparation 


Postvalidation 
Package 


B- Additional Tools 
E Direct Editor 


Prevalidation ra 


Installer Package: C:\Program 


Files\ InstallShield), AdminStudio},5.5\, Tutorial Author',Output',PackageForTheWe 


3.msi 
J 


Show "ERROR" messages 


Evaluation File: Full MSI Validation Suite 


ICEs to Run: al 


Cl Show "INFO" messages Show "WARNING" messages 


¥alidation 


To configure validation, first select the evaluation (.cub) file you want to validate against, | Give Us Feedback 


or click Browse to locate it. For best results, use the full logo-compliance evaluation 
files. Although you can enter individual Internal Consistency Evaluators (ICEs) to validate (separated 
by semicolons), it is best to evaluate all of them (All). 


You can select the level of information you want to display in the Output window by checking the Info, 
Warning, or Error check boxes. If the output has any error messages, it fails validation. 


Once you begin validation (either by clicking the MSI Validation or Transform Postvalidation toolbar 
buttons), the results are displayed in the Output window. 


In the Evaluation File field, click the arrow and select Full MSI Validation Suite from the list, and ensure 
the ICEs to Run field is set to All. 


Select the Show "ERROR" messages check box, and clear both the Show "INFO" messages and Show 
"WARNING" messages check boxes. If any errors occur during prevalidation, then the package fails 


the validation process. 
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4. Click Start. InstallShield Tuner begins the validation process, displaying its progress in the Output and 
Validation tabs of the Output window. 


When completed, a message appears indicating that the PackageForTheWeb 3.msi file has no 
validation errors. 


In the event that a Windows Installer package did have validation errors, it means that the package was not created to 
Microsoft's guidelines. Consult the online help for information about handling invalid packages. 


Customization 


Tuner can be used for a wide variety of customizations, including changing default destination and organization 
information, feature display and installation options, addition, modifications, and removal of files, INI files, registry 
information, and shortcuts, and configuration of ODBC resources and NT services. Some of these modifications are 
mote typical than others, so this tutorial concentrates on those modifications. 
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Specifying Default Destination and Organization Information 


To specify default destination and organization information: 


1. From the Tuner View List, expand Organization and select Product Properties to display the Product 
Properties View. 


PFTW1.mst (PackageForTheWeb 3.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


|o enea|omt +e» masto. :]o s 


5- Package validation Product Properties 
Prevalidation Property ¥alue 
5- Organization Default Destination Variable INSTALLDIR 
Product Properties Default Destination Path ProgramFilesFolder\InstallShield\PackageForTheweb 3 
B Features Company Name 
5- System Configuration 
o Files and Folders Default Destination Yariable 
Registry 


a Shortcuts This is the variable in which the Default Destination Path is stored. If you 


= INI Files change its value, it may cause adverse affects on the installation, For full 


“ea NT Services information, please refer to the Default Destination and Organization online help topic. 
(9 ODBC Resources 


B- Application Configuration 


g Server Locations Reset | This button resets the Default Destination behavior to its original (base MSI) 
[T] Setup Properties value, 


É Dialogs 
ra) Add/Remove Programs 
& © Package Preparation 
Postvalidation 
# Package 
S- Additional Tools 
Direct Editor 


2. Click on the value field for the Default Destination Path. Change the value to 
ProgramFilesFolder\InstallShield\AdminStudio\5.5\PFTW. This becomes the default destination 
directory when you run the setup. 


3. In the Company Name value field, provide the name of your organization (up to 30 characters). This is 
the default suggested organization when you run the setup. 


The Default Destination Variable has been selected by the application vendor (or Repackager) for specific reasons. 
Unless you have a substantial need to change it, you should avoid reassigning this value. Any changes have the 
potential to seriously hamper the installation. In the event you do inadvertently change this value, select it from the grid 
and click Reset fo revert to the original value from the base Windows Installer package. 
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During customization, you can also change how features are presented during setup. For example, you may want a 
specific feature installed by default, without giving a user the option to not install it from the Custom Setup panel 
during installation. 


To configure this feature to work as described above: 


1. On the Tuner View List, expand Organization and select Features from the View List. The Features View 
opens. 


PFTW1.mst (PackageForTheWeb 3.msi) - InstallShield Tuner 


|| File Edit View Go Project Tools Help 


joene@ DD ttes max 


©) Package Validation 
Prevalidation 

5- Organization 
Product Properties 
5 


=) System Configuration 


Files and Folders 
Registry 


Shortcuts 
INI Files 
NT Services 
ODBC Resources 
Zj B Application Configuration 
g Server Locations 
E Setup Properties 
&} Dialogs 
Ea Add/Remove Programs 
=) Package Preparation 


Postvalidation 
Package 


=) Additional Tools 
E] Direct Editor 


Features 

S-E PackageForTheWeb3NewFeat 
€) Help 
€ Languages 
€) HTML Help 
€) Program Files 
€ Signcodele4 
€ windows System Files 


toL: os 


Features @ 


Features are the building blocks of an 
installation from an end user's perspective. 

They represent a specific capability of the product—such as 
its help files or a part of a product suite—that can be 

installed or uninstalled based on the end user's selections. 
Features can be composed of subfeatures, which in turn can 
be composed of further subfeatures. Depending on the 
visibility of the "parent" feature, end users can select which 
portions of a feature to install in the Custom Setup dialog. 


Each feature and subfeature has properties that can be 
modified within Tuner. These include the feature's 
description (as it appears in the Custom Setup dialog), its 
visibility, and its initial state (not installed, installed locally, 
run from source, or advertised). Tuner allows you to change 
these feature properties to best suit your situation, For 
example, you may want to prevent a specific application 
within a suite from being installed. By changing its initial 
state and visibility, you can prevent your end user from ever 
seeing this feature during installation. 


2. Select PackageForThe Web3NewFeature from the Features tree. Information for that feature is listed. 


Y Features 


=) @ PackageForTheWeb3NewFeature 


©) Help 

€) Languages 

@) HTML Help 

Lv) Program Files 

€) SigncodelE4 

@) Windows System Files 


PackageForTheWeb3NewFeature 


Description 
Visible 
Initial State 


PackageForTheWeb3NewFeature 
Visible and Collapsed 
The Feature is installed on the local drive. 


3. Enter "This feature is for the AdminStudio tutorial." in the Description field. 


4. Click on the Visible property's value cell and change it to Not Visible. 


5. Click on the Initial State property's value and change it to The feature is installed on the local drive. 
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With these configurations, this feature and all its associated files will always be installed on the target computer. The 
end user will not have the opportunity to prevent the feature from installing because it will not be displayed in the 
Custom Setup panel during installation. 


Adding Files to the Installation 


One of the more common customizations to a setup is adding files. An example of when you might want to do this is 
if you have a series of custom templates to include with the setup. You can configure these templates to be installed to 
the correct location when the installation is performed. 


To add files to the installation: 


1. On the Tuner View List, expand System Configuration and select Files and Folders. The Files and 
Folders View opens. 
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|| File Edit Yiew Go Project Tools Help 


|joenea| omt +e» maxs esLos 


Files and Folders $ 


| Sj Package Validation | | Source computer's directory tree Source computer's files 
Prevalidation 
be nii 
7 pd rodut pro erties a My computer 
p My Network Places 
Features 


= M 
B- System Configuration y Documents 


Files and Folders 
Registry 


OFJ Shortcuts 
> INI Files 
Sa NT Services - 
H ODBC Resources J Destination Computer F Sze | Attri, 
5-6 Application Configuration H-E CommonFilesFolder 
g Server Locations H- ProgramFilesFolder 
[E] Setup Properties {© SystemFolder 
É Dialogs E WindowsFolder 
B Add/Remove Programs 
5- Package Preparation 
Ready 


Ej 


Destination computer's folders Destination computer's files 


2. In the Source computer's directory tree pane, navigate to <AdminStudio 
Directory>\Tutorial\Tuner\Files. 
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3. In the Destination computer's folders pane, right click on Destination Computer and select 
ProgramFilesFolder from the Show Folder submenu (if ProgramFilesFolder is not visible). Expand this 
folder until you see the PackageForTheWeb 3 folder. Select this folder. 
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Daor) 


5- Package Validation 
Prevalidation 
4 Organization 
Product Properties 
& Features 
=| em) System Configuration 
QO Files and Folders 
a Registry 
OEY Shortcuts 
INI Files 
NT Services 
ODBC Resources 
5- Application Configuration 
8 Server Locations 
[E] Setup Properties 
É Dialogs 
x Add/Remove Programs 
3- Package Preparation 


4) Postvalidation 
Package 


B- Additional Tools 
E] Direct Editor 


Source computer's directory tree 


H- ConflictSol A 
fH Repackage 
B- Tuner 
© Files 
H- Outpu 
© Source 
H- AdminStudio 5 Evaluat 
H- DemoShield 
w- DevStudio 9 
E-M DevStudio Evaluation I% 
| > 


Destination computer's folders 


Destination Computer 
=) CommonFilesFolder 
B- ProgramFilesFolder 
S- InstallShield 
8 (> PackageForTheWeb 3 
{© SystemFolder 
{© WindowsFolder 


Source computer's files 


Name 
Æ] AdminStudioTutorial.htm 
[E] AdminStudioTutorial.txt 


Destination computer's files 


4 
Q 
ü 
P 
P 
P 
P 
A 


Name 
readme, htm 
pftwlogo.gif 
PFtwwiz.chm 
signer dll 
signcode.exe 
chktrust.exe 
prtwwiz.exe 
stub32i,.exe 


Files and Folders $ 


Size Type Modified 
136 bytes HTML Doc... 


42 bytes Text Docu... 


Attri... Component ^ 
Folder_Package 
Folder_Package 
pftwwiz.chm 
signer dll 
signcode.exe 
chktrust.exe 
prtwwiz.exe_Cr 
stub32i.exe 


4. Select the AdminStudioTutorial.htm and AdminStudioTutorial.txt files from the Source computer's files 
pane and drag them to the Destination computer's files pane. 


These files, which are not part of the original PackageForTheWeb installation, will be installed when this transform is 
used with the base Windows Installer package. 
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Creating Shortcuts 


Another common customization to make with InstallShield Tuner is to create additional shortcuts. These can be to 
files in the original Windows Installer package, to files added during your customization, or to files already on the 
target system. In this example, you are going to create a shortcut to Notepad in the PackageForTheWeb 3 folder. 


To create the shortcut: 


1. On the Tuner View List, expand System Configuration and select Shortcuts. The Shortcuts View opens. 
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oax) 


| File Edit View Go Project Tools Help 


jpon@|DD|\t +> mas tono 


B- Package Validation 
Prevalidation 
B- Organization 
Product Properties 
Features 
& © System Configuration 


Files and Folders 
Registry 
lear 


INI Files 
NT Services 
g% ODBC Resources 
= Application Configuration 
g Server Locations 
[E] Setup Properties 
E Dialogs 
A Add/Remove Programs 
B- Package Preparation 


Postvalidation 
# Package 
5- Additional Tools 
E Direct Editor 


Destination Computer 
1) ProgramMenuFolder 
ICON_NAME 
InstallShield PackageForThe 


Shortcuts fā 
Shortcuts / Folders 


The Shortcuts view offers an integrated, visual 
method for adding shortcuts and program folders to 

the installation. Existing shortcuts can also be modified or 

removed. Each shortcut has several properties that specify the 
target program, hot key combination, icon, and other information 
necessary to launch the application from the shortcut. 


Shortcuts can be placed in folders already defined by the 
installation, standard folders that are predefined by the Windows 
Installer {such as the Desktop folder), or in new folders which you 
can create. You can drag and drop shortcuts to different folder 
locations, but you cannot drag and drop folders. All predefined MSI 
folders are denoted with a different icon, and cannot be deleted or 
renamed. If an MSI-defined folder is not visible, right-click on a 
folder and select the folder you want to display from the Show 
Folder submenu. Folders that contain shortcuts in the base 
Windows Installer package appear in the Shortcuts/Folders view by 
default. 


You must define the Icon, Target, and Run properties for each 
shortcut. 


2. Click on the folder where you want to add the shortcut. In this case, you are going to place the shortcut 
in the PackageForTheWeb 3 folder in ProgramFilesFolder. However, since the ProgramFilesFolder is not 
displayed in the Shortcuts View, right-click on the top-level Shortcuts folder and select 
ProgramFilesFolder from the Show Folder submenu. 
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3. Expand ProgramFilesFolder, then InstallShield Software Corporation, so you can see the 
PackageForTheWeb 3 folder. 


Y Destination Computer 
B- ProgramFilesFolder 


B- InstallShield 


H- PackageForTheWeb 3 
H- My Company Name 


=) ProgramMenuFolder 
E ICON_NAME 


E InstallShield PackageForTheWeb 3 
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|| Bile Edit View Go Project Tools Help 


4. Right-click the PackageForTheWeb 3 folder and select New Shortcut. Name this shortcut Notepad. 


DoR 


jenem tte» mas toL 


S- Package Validation 
EE] Prevalidation 

S- Organization 
Product Properties 
B Features 


Destination Computer 
S- ProgramFilesFolder 
S- InstallShield 
S- PackageForTheweb 3 
{© Languages 
Æ Notepad 


Shortcuts à 


Arguments 
Target Type Destination Folder 
Target TARGETDIR 


B- System Configuration 
Files and Folders 4) My Company Name Run Normal Window 
Registry =) ProgramMenuFolder Working Directory 
O Shortcuts E ICON_NAME Hot Key 
INI Files InstallShield PackageForThewWeb 3 
NT Services 
ODBC Resources 
S- Application Configuration 
g Server Locations 
[E] Setup Properties 
É Dialogs 
Eas Add/Remove Programs 
a © Package Preparation 


Postvalidation 
Package 


2- Additional Tools 
E Direct Editor 


This property displays the name of the icon for this | Give Us Feedback 


shortcut. You can change it by clicking the Change 

Icon button, From the resulting dialog, you can browse to an EXE 
file or DLL, which will then display all contained icons. Select the 
appropriate icon and click OK. The name of the icon will appear in 
the Icon value cell, and a picture of the icon will appear next to 
the Change Icon button. 


Change Icon... | Clear Icon | 


5. When Tuner displays the properties for the new shortcut, perform the following configurations: 
a. Select the Icon property and click the Change Icon button in the pane below the properties grid. 
b. Click Browse, navigate to the Windows directory, and double-click Notepad.exe. 
c. Select one of the icons and click OK. 
d. Change the Target Type to File from file system. 
e. In the Target row, enter the value WindowsFolder\Notepad.exe. 
f. Double-click the Run value and select Normal window from the drop-down menu. 


When the installation is installed, this shortcut will be placed in the PackageForTheWeb 3 folder on the target system. 
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Configuring Add/Remove Programs 


Windows 2000 and XP provide additional functionality to the Add/Remove Programs control panel. InstallShield 
Tuner enables you to modify settings pertaining to this in your customization. In this example, you are going to 
disable the control panel setting that allows users to modify a setup after it has been installed. 


gi 
Bi 
To set the Modify property in for Add/Remove Programs: 


1. From the Tuner View List, expand Application Configuration and select Add/Remove Programs to 
display the Add/Remove Programs View. 
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|| File Edit View Go Project Tools Help 


j;ens|DD|t+e> | Bax eoo 


= Package Validation 
Prevalidation 

4 Organization 
Product Properties 
D Features 


Add/Remove Programs Setting 

Property ¥alue 

Publisher URL http://www. installshield.com 
Product Info and Update URL 


Help URL http://www. installshield.com 


4) System Configuration 
Files and Folders 
Registry 
Shortcuts 
INI Files 
NT Services 
ODBC Resources 
a- Application Configuration 
g Server Locations 
[E] Setup Properties 
g Dialogs 


ej Add/Remove Programs 


5- Package Preparation 


Postvalidation 
R Package 
S- Additional Tools 
Direct Editor 


Help Telephone 
Contact Person 
Comments 

Disable Modify Button 
Disable Remove Button 
Disable Repair Button 


Disable Repair Button 


This property, which corresponds to the ARPNOREPAIR property in the Setup Properties view, 
provides a way to prevent users from running the application setup to repair missing or corrupt 
product files. 


When you double-click on the Value cell, No and Yes appear as choices in a combo box. 


This property refers to the repair option in Add/Remove Programs, and not to dialogs displayed when a setup 
is run in maintenance mode. 


2. Double-click the Value field to the right of the Disable Modify Button property. 


3. From the drop-down menu, select Yes. 


When this installation and transform are run on a Windows 2000 or XP operating system, users will not be permitted 
to use the Modify function for this setup in the Add/Remove Programs dialog. 
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Postvalidation 


After you have performed customizations, and prior to packaging the base Windows Installer package and transform, 
you need to postvalidate it. This ensures that your transform did not introduce validation issues that were not present 
in the base Windows Installer package. In some circumstances, you can use a transform to correct validation errors 
identified during prevalidation. However, in this example, you are only concerned that you did not introduce errors 
within the transform. 


gS 


Bi 


To postvalidate the combination of the base Windows Installer package and transform 
file: 


1. On the Tuner View List, expand Package Preparation and select Postvalidation. The Postvalidation View 
opens. 
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|| File Edit View Go Project Tools Help 


j7pen@|Do|t++> | Bart |\eo.!\o@ 


Postvalidation ¥ 
=) Package Validation 
E Prevalidation Installer Package: C:\Program 
) Organization Files) InstallShield) AdminStudio\5.5\ Tutorial Author Output’,PackageForTheWe 
Product Properties 3.msi 
B Features 


E-E System Configuration Evaluation File: Full MSI Validation Suite v 
2 Files and Folders 
: ICEs to Run: All Start 
BF Registry 


Shortcuts 
A INI Files C] Show "INFO" messages C] Show "WARNING" messages Show "ERROR" messages 


NT Services 
ODBC Resources 


a- Application Configuration 
Server Locations 


[E] Setup Properties : ee . . F k . 
©) Dialogs To configure validation, first select the evaluation (.cub) file you want to validate against, or 


B Add/Remove Programs click Browse to locate it. For best results, use the full logo-compliance evaluation files, Although 
g E Package Preparation you can enter individual Internal Consistency Evaluators (ICEs) to validate (separated by semicolons), it is 


a Postvalidation best to evaluate all of them (All), 

£) Package 

S- Additional Tools You can select the level of information you want to display in the Output window by checking the Info, Warning, 
Direct Editor or Error check boxes. If the output has any error messages, it fails validation. 


¥alidation 


Once you begin validation (either by clicking the MSI Validation or Transform Postvalidation toolbar buttons), 
the results are displayed in the Output window, 


2. Ensure that the ERROR box is checked, but the WARNING and INFO boxes are unchecked. 
3. Select Full MSI Validation Suite as the Evaluation File. 
4. Click Start. Messages will appear in the Output and Validation tabs of the Output window. 


When postvalidation completes, you are informed that the combined Windows Installer package and transform are 
valid according to Microsoft guidelines. 
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Packaging 


In the final part of this tutorial, you will package the original Windows Installer package and transform into a single 
executable file (Setup.exe). This file will begin the installation, including all modifications you made. 


UWS 


To package the Windows Installer installation and transform: 


1. In Tuner, select Packaging Wizard from the Project menu. The Packaging Wizard Location Panel 
opens. 


Packaging Wizard 


Location 
Network Location or FTP location 


The installation along with the transforms and the Files will be copied to the Following network 
location. Press the browse button to locate the directory to copy the installation files to. 


| C:\Documents and Settings\PatriciaHowe\My Documents}, 


O FTP Server 
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2. Select the Network Location option and set the location to <AdminStudio 
Directory>\Tutorial\Tuner\Output\Packaged. Click Next. The Setup.exe Panel opens. 


Packaging Wizard 


Setup.exe 
Options For Setup.exe and Windows Installer 


Seite 
1ECK E 


nd line argument 


Include Wing SI Engine 


Include WinNT MSI Engine 


Windows Installer Command Line Arguments 


3. Click the Create Installation Launcher box, and check both the include engine boxes. This ensures that, 
should the Windows Installer engine not be installed on the target system, that it will be installed so that 
installation of your package can occur. Click Next. The SMS Panel opens. 


Packaging Wizard 


SMS 
Options For SMS 


Package Definition File 
4 package definition file is a text file that contains all the information necessary to create a 
software distribution package for an application, SMS 1.2 or earlier uses PDF file extension. 
SMS 2.0 or later uses SMS file extension, 


Cl Create SM5 file (SMS 2.0 or later) 


F your installation will be ru 


eniviror 


stall MIF Filename 


Uninstall MIF Filename 
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4. In the SMS Panel, ensure all boxes are unchecked and click Next.The Packaging Summary Panel 
opens. 


Packaging Wizard 


Packaging Summary 
Options selected in the previous panels. 


Summary 


Location 
Copy To Network Location: C:\Program Files\InstallShield\AdminStudio\S.5 
\Tutorial\Tuner\Output\Packaged 


Setup.exe 
Setup.Exe : Yes 
WinNT Engine ; Yes 
Win9X Engine : Yes 
Windows Installer Command Line: 


SMS 
PDF (SMS 1.2 or earlier) : No 
PDF file (SMS version 2.0 or later) : No 


5. Review the selected options and click Finish. The Packaging tab of the Output window displays the 
packaging progress. 


The executable, and all necessary files, are now stored at: 


<AdminStudio Directory>\Tutorial\Tuner\Output\Packaged 


Further Customizations 


InstallShield Tuner is capable of many customizations not included in this tutorial. For example, your package may 
contain ODBC resources, NT Services, or INI files that need configuration. Additionally, you may want to modify the 
files installed, or even change registry settings. InstallShield Tuner provides flexibility to create these types of 
customizations depending on your individual needs. Please review the Customizing Packages section of this online 
help system for further details. 
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Identifying and Resolving Conflicts 


ConflictSolver can identify and resolve conflicts that exist between multiple Windows Installer packages, ensuring 
proper functioning of installations. 


Opening ConflictSolver and Accessing the 
Database 


The first step in using ConflictSolver is to launch it and connect to an Application Catalog. For purposes of this 
tutorial, use the sample Access-based Application Catalog included with ConflictSolver, which contains information 
about common Windows Installer packages. 


To open ConflictSolver and access the proper database: 
1. From AdminStudio, launch ConflictSolver. The ConflictSolver Group View opens. 


Sample.mdb - InstallShield ConflictSolver 


|| Catalog Edit Yiew Conflicts Reports Tools Help 


= Groups 

Group View 
a a Accounting Select an item to view its Name Description 
w- Application Development properties, (GRAccounting 


& C ; 
+ (gj Common (GR Application Development 


H- CRM 
(4) Graphics (Common 


H- Sales crm : 
E- Systems Administration Graphics 


H- Web Development (Sales 
O Systems Administration 


E web Development 


Products $ Merge Modules 


Output A, Import A, Validate A, Conflicts A Remote Package Alert A Search Results 
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2. From the Catalog menu, select Connect. The Connect to Application Catalog Dialog opens. 


Connect to Application Catalog 


a o 
| 


O Microsoft SOL Server / MSDE 
= 


IG) 


If you want to connect to an existing AdminStudio Application 


Open 
Catalog, specify it here and click Open. =por 


3. In the Connect to Application Catalog Dialog, click the Recent tab and select the Sample database. 
4. Click Open. 
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Configuring ConflictSolver Options 


Before importing the package into the database and identifying conflicts, you need to configure the ConflictSolver 
options pertaining to import, and conflict identification. 


To configure these options: 


1. In ConflictSolver, select Options from the Tools menu. The General tab of the Options Dialog opens. 


Options 


‘ Extended Attributes aime Duplicate Package 
General || Import || Validate || Resolution 


Confcts | 


Report Location 


|m Files\InstallS hield\AdminStudio\5. 5\ConflictS olver\Reports\Standard ] ka 


Options 

C] Confirm All Drag-Drop Operations 

Display Broken MSI/MST Package Links 
C] Only Display View Nodes with Data 


OS Snapshot Display Limits 


[100 Records 


InstallShield Software Corporation © 2004 1077 


AdminStudio 5.5 User Guide 14 AdminStudio Application Migration Tutorial 


2. Click Resolution to display the Resolution Tab. 


Options 


Extended Attributes I Duplicate Package 
Resolution Conflicts 


Resolution Options 
Preview and approve all resolutions 
Maximize user flexibility in selecting resolutions 


3. Ensure the Perform resolutions against a transform file option is selected. 
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4. Click Conflicts to display the Conflicts Tab. 


Options 
Extended Attributes | Duplicate Package ? 
General | Import | Validate || Resolution | Conflicts 


Suppress 


Cl Info 


Predefined and Custom ACE Rules 


o E6 Conflict Types 
J Components 
a- CG File Extensions 
H-E Files 
a EG INI Files 
H- NT Services 
a- ODBC Resources 
(© Product Properties 
© Registry 
© Shortcuts 


2) ee 
O00 


Custom ACE Rule File 
C:\AdminStudio Shared\ConflictS olver\CustomConflictFile. ace | Browse... 


5. Ensure that both Suppress options are unchecked. This enables you to see all messages about conflicts. 


6. Under Predefined and Custom ACE Rules, select Conflict Types to have ConflictSolver check for all 
conflicts by default. 


7. Click OK to close the Options Dialog. 


Creating a Group and Importing the Package 


Once you have configured the default options, you can create a new group and import the package and transform into 
ConflictSolver. You can then run conflict identification against it. 


gi ` 

Bi 

To create a new group: 

1. On the ConflictSolver Products View, right-click on the root Groups node and select New Group. 
2. Name the new group AdminStudio Tutorial. 


3. Press Return. 
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To import the Windows Installer package and associated transforms: 


1. Right-click the AdminStudio Tutorial group, point to Import select MSI Package. The Import Wizard MSI 


Source Information Panel opens. 


Import Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Select one MSI package file [MSI] in order to proceed with the import process. You may 
optionally select one or more transform files (MST) to be associated with the package file. 


| 
Transforms [.mst): a [x | +t | + | 


Select an MSI file: 


Advanced Options 


2. Next to the Select an MSI file field, click Browse, navigate to <AdminStudio 
Directory>\Tutorial\Author\output, and select PackageForTheweb 3.msi. 
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4. In the Transforms area, click Browse (...) and navigate to <AdminStudio 
Directory>\Tutorial\Tuner\Output and select PFTW.mst. 


Import Wizard 


MSI Source Information 
Specify the MSI file along with any transforms. 


Select one MSI package file (MSI) in order to proceed with the import process. You may 
optionally select one or more transform files (MST) to be associated with the package file. 


Select an MSI file: 
IShield\AdminStudio\5. 5\T utorial\4uthor’Output\PackageF orl heWeb 3.msi | Browse... 


Transforms [.mst]: 


Import Wizard 


Summary 
Review your options. 


MSI file to import: 
PackageForT heWeb 3.msi 


Transform{s): 
PFTW.mst 


Destination group{s) for the package: 
AdminStudio Tutorial 


Options: 
Validate the package before importing? No 
Check for conflicts before importing? No 
Import custom tables? Yes 
Import binary data? Yes 


$i i 


Click Finish to accept these options. 


6. Review the options selected in the Summary Panel and click Finish. 


The Import process displays its progress in the Import tab of the Output Window. 
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identifying Conflicts 


Once you have imported the package and transform, you should identify conflicts between it and other packages in 
ConflictSolver. For this tutorial, you are going to look for component conflicts between your package and Acrobat 
Reader 5.0. 


To identify conflicts: 


1. In ConflictSolver select Conflict Wizard from the Conflicts menu. The Conflict Wizard Welcome Panel 
opens. 


Conflict Wizard 


Welcome to the Conflict Wizard 


The Conflict Wizard allows you to check for conflicts 
between an external Windows Installer package and 
other packages already stored in the AdminStudio 
Application Catalog. 


Click Next to continue. 
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2. On the Welcome panel, click Next. The Source Type Panel opens. 


Conflict Wizard 


Source Type 
Specify the source type. 


Select whether the source package is stored externally or within the Application Catalog. Click 
Next to continue. 


© Api 


Check for conflicts between packages within the AdminStudio Application Catalog. 


O Windows Installer package 


Check for conflicts between packages in the AdminStudio Application Catalog and 
external MSI file, 


Í i It is faster to perform conflict detection between internal application packages 


than it is to check against an external Windows Installer package. To improve 
performance, run conflict detection between internal packages 


3. On the Source Type Panel, select Internal Application Catalog package and click Next. The Source 
Package Panel opens. 


Conflict Wizard 


Source Package 
Specify the source package. 


Select a source package to analyze for conflicts and click Next to continue. 
a 06 
-6 Accounting 
EI AdminStudio Tutorial 
OG PackageForTheweb 3a v3.00 
Oe Application Development 
(i Common 
Oe crm 
| Graphics 
Cl Sales 


(©) Systems Administration 


Qa uib ed ee 


ei 
Select All Clear All 
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4. In the Source Package panel, select PackageForTheWeb 3 (v3.00) from the AdminStudio Tutorial 
group. Click Next. The Target Information Panel opens. 


Conflict Wizard 


Target Information 
Specify the target products, 


Select the groups or products against which you want to compare the source package for 
conflicts. Click Next to continue. 


a DO 
-C Accounting 
H Oe Application Development 
-C Common 


ee crm 

5-6 Graphics 

#1} Sales 

a-l Systems Administration 
-C6 Web Development 


5. In the Target Information Panel, ensure only Adobe Acrobat Reader v5.0 (located in the Common 
group) is selected. Click Next. The Conflict Options Panel opens. 


Conflict Wizard 


Conflict Options 
Specify the conflict options. 


Select the conflicts to detect and click Next to continue. 


a El Conflict Types 
a- Components 

a-v] File Extensions 

© Files 

© 

E NT Services 

E ODBC Resources 
(© Product Properties 
E Registry 

(© Shortcuts 


(JRun Resolution [_] Generate Reports 


SINOONSS 


6. In the Conflict Options Panel, click Clear All, and then select Components. 


7. Ensure both the Run Resolution and Generate Options options are cleared. 
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8. Click Next. The Summary Panel opens. 


Conflict Wizard 


Summary 
Review the conflict options. 


Source: 
PackageForTheWeb 3a (3.00) 


Checking for conflicts against: 
Adobe Acrobat Reader 5.0 (5.0) 


Conflict Selection Information: 
Howe 
ACEO2 
ACEO4 
ACEOS 
ACEO6 
ACEO9 


olution: No 


a eee ee 


9. Review the settings for the Conflict Wizard and click Finish. 


Messages for conflict identification are displayed in the Conflicts tab in the Output window. 


ACE Type Description 

x) ACEO4 Error The component 'CST_COMPONENT' in the package 'PackageForTheWeb 3' does not have a key file 
x] ACEO4 Error The component 'CST_COMPONENT1' in the package 'PackageForTheWeb 3' does not have a key Fil 
ix] ACEO6 Error The component ‘pftwwiz.chm’ in the package 'PackageForTheWeb 3' does not have an executable 


| > 


Import A, Validate A, Conflicts A Remote Package Alert A Search Results 7 


When finished, you find that ACE04 and ACE06 conflicts exist between the PackageForTheWeb 3.msi/PFTW.mst 
transform combination and Adobe Acrobat Reader v5.0. You can now tesolve the conflicts. 
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Resolving Conflicts and Reimporting the Package 


Once conflicts have been identified, you can resolve some conflicts automatically in the Conflicts view. Others may 


need manual resolution using DevStudio or Tuner. For this tutorial, all conflicts can be resolved manually. 


To resolve identified conflicts: 


1. Select the Conflicts view for PackageForTheWeb 3 (v3.00). 


Sample.mdb - InstallShield ConflictSolver 


|| catalog Edit view Conflicts Reports Tools Help 


ixxi Se PackageForTheWeb 3 
= © Groups S co W 


H- Accounting PRF : 


=| PackageForTheWeb 3b (v3,00) Summary 


3% Conflicts = - 
EF Extended Attributes When conflict identification was performed on 'PackageForTheWeb 3' on 'Tuesday, January 27, 2004 - 4:19 
3 Files/Components PM", a total of 3 conflicts) were identified, of which 3 are automatically resolvable, by checking a total of; 


INI File Changes 


Merge Modules Lproduct(s), 


: using 6 ACE rule(s). 
B® Registry 
E Shortcuts None of these product(s} have been updated. 
E] Tables None of these product(s) have been deleted. 
a- Application Development No new product(s) have been added to the AdminStudio Application Catalog, 


=- Common Resolution Options 


a- CRM 


=- Graphics The conflict resolution options For this package are to: 

# () Sales Resolve Conflicts; Save the resolutions within a transform file, 

H- Systems Administration C:\,.. \AdminStudio\5, 5) Tutorial Tuner\Output\Packaged\PackageForTheWeb 3.mst 
E- Web Development 


Products b4 Merge Modules 


You can modify these resolution options by selecting ‘Edit’. 


2. Notice in the Resolution Options area that a transform file is designated as the location to save all 


resolutions. This is because you elected to use transforms for resolutions when setting up ConflictSolver 


options. 
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3. Change the Conflict Information list to Component Conflicts. This displays conflict details for each 
component conflict identified. Expand each of the ACEs listed in this view to read specific information 
about the conflicts. 


Sample.mdb - InstallShield ConflictSolver 


| Catalog Edit View Conflicts Reports Tools Help 


zixl h= PackageForTheWeb 3 
= ( Groups aN Conflict 
E-E Accounting i 
È- Adminstudio Tutorial SEE Component Conflicts v 
Fy PackageForTheWeb 3b (v3.00) Conflict Details 
SR Conflicts E 
A Extended Attributes | The component 'CST_COMPONENT' has an empty keypath which needs an entry in the CreateF 
3 Files/Components 


, @ The component ‘CST_COMPONENT1' has an empty keypath which needs an entry in the Create 
INI File Changes lg eN ACEO6 


Merge Modules | 
EA Registry 
E Shortcuts 
Tables 
H-E Application Development 
H-E Common 
-E CRM 
H- Graphics 
H- Sales 
H- Systems Administration 
+) Web Development | f E 


@ The component 'pftwwiz.chm' does not have an executable module (*.chm, *.dll, *.drv, *,exe, 


zi Resolve | Resolve All 
Products $ Merge Modules 


4. Click Resolve All. The CARD Resolution Options Dialog appears prompting you to make a selection to 
determine how conflict resolution will proceed. 


CARDO6 - Resolution Options 


CARDOE will update the 'pftwwiz.chm' component 'KeyPath' field with your 
selection. 


Files 


Pftwwiz chm 


The CARD Resolution Options Dialog only appears if the Maximize user flexibility in selecting resolutions 
option is selected on the Resolution Tab of the Options Dialog. 
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5. Select Pftwwiz.chm and click OK. The Resolution Details Dialog opens, listing the proposed CARD 
resolutions that will be made to the package. 


Resolution Details 


The CARD resolutions will execute the Following changes to the package. Please approve the 
changes before the resolution process can be completed, 


CARD Details 


Information Details 

Sicarpos Add a 'CreateFolder' entry for ‘CST_COMPONENT' component. 
Scarvo¢ Add a 'CreateFolder' entry for 'CST_COMPONENT1' component, 
acara Change the component key file to 'pftwwiz.chm', 


The Resolution Details Dialog only appears if the Preview and approve all resolutions option is selected on the 
Resolution Tab of the Options Dialog. If this option is not selected, this dialog does not appear. If you do not 
want this dialog to appear, select the Don't show this dialog again checkbox on the dialog. This is equivalent 
to unselecting the Preview and approve all resolutions option on the Resolution Tab of the Options Dialog. 


6. Select all of the CARD resolutions click Approve. The identified conflicts are resolved. 


7. Change the Conflict Information list back to Summary. 


Sample.mdb - InstallShield ConflictSolver 
| Catalog Edi 


= = — = PackageForTheWeb 3 
5 (&j Groups "aM conflict Vie 
S-E Accounting oat = 
eh a Conflict Information : 
S- PackageForTheWeb 3b (v3.00) Summary 
S Conflicts ee — mmm NEEE eee 
Ef} Extended Attributes When conflict identification was performed on 'PackageForTheWeb 3' on ‘Tuesday, January 27, 2004 - 
Files{Components 4:19 PM’, a total of 3 conflicts) were identified, of which 3 are automatically resolvable, by checking a 


total of: 
INI File Changes 


Merge Modules L product(s), 
using 6 ACE rule(s), 


Registry - 
E Shortcuts None of these product(s) have been updated. 
ima Tables None of these product(s) have been deleted, 
S-E Application Development No new product(s) have been added to the AdminStudio Application Catalog. 


(5) Common Resolution Options 


H- CRM = g _ 
S-E Graphics The conflict resolution options for this package are to: 


H- Sales Resolve Conflicts: Save the resolutions within a transform file. 
(Sy Systems Administration Ci}... \AdminStudio\S.5\ Tutorial Tuner\Output\Packaged\PackageForThe Web 3.mst 


S-E Web Development 


Products $ Merge Modules 


You can modify these resolution options by selecting 'Edit', 
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You can now reimport the package. This includes the PPFTW.mst transform, as it is considered to be part of the 
original package. The reimport also includes the PackageForTheWeb 3.mst transform which contains the resolutions 
you made. 


To reimport the package and transforms: 


With Summary selected in the Conflict Information list, click Reimport. 


Checking for Conflicts a Second Time 


Although optional, it is generally a good practice to check that the conflicts you automatically resolved were resolved 
correctly. Doing so involves running the Conflict Wizard a second time and checking the package and resolution 
transform for conflicts. 


ZA wi . \ 
To verify conflicts have been resolved: 
1. Select Conflict Wizard from the Conflicts menu. 
2. On the Welcome Panel, click Next. 
3. On the Source Type Panel, select Internal Application Catalog package and click Next. 
4 


. On the Source Package Panel, select PackageForTheWeb 3 (v3.00) from the AdminStudio Tutorial 
group. Click Next. 


5. On the Target Information Panel, ensure only Adobe Acrobat Reader v5.0 (located in the Common 
group) is selected. Click Next. 


6. In the Conflict Options Panel, click Clear All, and then select Components. 

7. Ensure both the Run Resolution and Generate Options options are cleared. 

8. Click Next. 

9. Review the settings for the Conflict Wizard on the Summary Panel and click Finish. 


The messages about the conflict identification process are displayed in the Conflicts Tab of the Output Window. 
When finished, you find that no conflicts remain. 
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Conclusion 


This tutorial is by no means comprehensive; rather, it is designed as an introduction to the AdminStudio workflow for 
many administrators. It is entirely possible that some aspects of AdminStudio will be used daily, while others 
infrequently. The flexibility of AdminStudio ensures that—no matter what your needs are—you have the tools to 
address your application migration needs. 
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